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PREFACE 



This manual describes the IBM 1130 Assembler 
language and defines the programming rules. It is 
intended as reference material for the writing of 
an assembler source program and the accomplish- 
ment of the steps required to produce the resulting 
object program. For those without programming 
experience or a knowledge of the principles involved, 
the IBM publication, Introduction to IBM Data 
Processing Systems (Form F22-6517), is suggested 
as preliminary reading. 

Within this publication, all references to the 
"Monitor System" apply to Version 1 and Version 
2. Where the reference only applies to Version 1, 
the abbreviation DM1 is used. Where the reference 
only applies to Version 2, DM2 is used. 

The term "loader" as it applies to the 1130 
programming systems bav3 the following 
meanings: 

Card/Paper Tape - Relocating Loader 

Disk Monitor 1 - Loader 

Disk Monitor 2 - Core Load Builder 



The reader should also be familiar with the 
following: IBM 1130 Functional Characteristics 
(Form A26-5881) and IBM 1130 Computing System, 
Input/Output Units (Form A26-5890). 

The assembler language is valid for the 1130 
Disk Monitor Programming Systems and the 1130 Card/ 
Paper Tape Programming System. The operating 
procedures for the Monitor Assembler are described 
in the publications IBM 1130 Disk Monitor System 
Reference Manual (Form C26-3750), and IBM 1130 
Disk Monitor System, Version 2, Programming and 
Operator's Guide (Form (C 26 -3 7 17). 

The operating procedures for the 1130 Card/ 
Paper Tape Assembler are described in the publication 
IBM 1130 Card/Paper Tape Programming System 
Operator's Guide (Form C26-3629). 

The library subroutines for the 1130 systems 
are described in the IBM 1130 Subroutines Library 
manual, (Form C26-5929). 

MACHINE REQUIREMENTS 

The minimum machine configuration for assembling 
programs is as follows: 
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For those without experience involving different 
number systems, i.e. , binary and hexadecimal, 
the publication IBM Student Text: Number Systems 
(Form C20-1618) is recommended. 



IBM 1131 Central Processing Unit, Model 1, 

with 4096 words of core storage 
IBM 1442 Card Read Punch, or IBM 1134 Paper 

Tape Reader and IBM 1055 Paper Tape Punch. 



Fifth Editi on 

This edition is a revision of the previous edition (C26-5927-3) which is now obsolete. 
Information has been added to distinguish between Version 1 and Version 2 of the 
1130 Disk Monitor System. 

Significant changes or additions to the specifications contained in this publication will 
be reported in subsequent revisions or Technical Newsletters. 

Requests for copies of IBM publications should be made to your IBM representative or 
to the IBM branch office serving your locality. 

A form is provided at the back of this publication for reader's comments. If the form 
has been removed, comments may be addressed to IBM Nordic Laboratory, Technical 
Communications Department, Vesslevagen 3, Lidingo, Sweden. 
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GENERAL DESCRIPTION 



INTRODUCTION 

The IBM 1130 Assembler language replaces binary 
instruction codes with mnemonic symbols and uses 
labels for other fields of an instruction. Other fea- 
tures, such as pseudo-operations, expand the pro- 
gramming facilities of machine language. Thus, 
the programmer has available, through an assem- 
bler language, all the flexibility and versatility of 
machine language, plus facilities that greatly reduce 
machine language programming effort. 



Symbolic Language 

Symbolic language is the notation used by the pro- 
grammer to write (code) the program. A program 
written in symbolic language is called a source pro- 
gram. It consists of systematically arranged 
mnemonic operation codes, special characters, 
addresses, and data, which symbolically describe the 
problem to be solved by the computer. 
The use of symbolic language: 

• Makes a program independent of absolute core 
locations , thus allowing programs and subroutines 
to be relocated and combined as desired. 

• Allows subroutines that can be written indepen- 
dently and that cause no loss of efficiency in the 
final program. 

• Permits instructions to be added to or deleted 
from a source program without the user having 
to reassign storage addresses. 



Assembler Program 



program is created in the system Working Storage 
and the listing, if requested, is produced. 

The IBM 1130 Card/Paper Tape Assembler is a 
two-pass program. It is loaded into the computer 
and is followed by the first pass of the source program. 
During the first pass, the source statements are 
read and a symbol table is generated. During the 
second pass, the source program is read again and 
the object program and/or error indications are 
punched into the first 20 columns of each source card. 
If paper tape is used, the second pass results in the 
punching of a new tape that contains both source state- 
ments and corresponding object information. Both 
card and tape object programs must be compressed 
(via a Compressor Program supplied with the assem- 
bler) into a relocatable binary deck (or tape) before 
they can be loaded into core storage for execution. 
The output from the second pass is called the list 
deck (or tape) and can be used to obtain a program 
listing of source statements and corresponding object 
statements. 



Subroutines 

A library of input/output, arithmetic, and functional 
subroutines is available for use with the IBM 1130 
Assembler. 

The user can incorporate any subroutine into his 
program by simply writing a call statement (CALL or 
LIBF, whichever is required), referring to the sub- 
routine name. The assembler generates the linkage 
necessary to provide a path to the subroutine and a 
return path to the user's program. The ability to use 
subroutines simplifies programming and reduces the 
time required to write a program. 

A description of available subroutines is con- 
tained in the system subroutine library manual. 



The assembler program converts (assembles) a 
source program into a machine -language program. 
The conversion usually is one for one — that is, the 
assembler produces one machine -language instruc- 
tion for each symbolic-language instruction. 

The 1130 Disk Monitor Assembler is a two-pass 
assembler. The source program is read into core 
from the principal input device and written on the disk 
for use in pass 2. During the first pass the symbol 
table is generated. During the second pass the object 



FEATURES OF THE ASSEMBLER 

The significant features of the IBM 1130 Assembler 
are summarized below. More detailed explanations 
are given later in this manual. 

Mnemonic Operation Codes. Mnemonic operation 
codes are used for all machine instructions instead 



General Description 1 



of the more cumbersome internal binary operation 
codes of the machine. For example, the Subtract 
instruction can be represented by the mnemonic, S, 
instead of the machine operation code, 10010. 

Symbolic References to Storage Addresses. Instruc- 
tions, data areas, and other program elements can 
be referred to by symbolic names or actual machine 
addresses and designations. 

Renaming Symbols. A symbolic name can be equated 
to another symbol, so that both refer to the same 
storage location. This makes it possible for the 
same program item to be referred to by different 
names in different parts of the program. 

Automatic Storage Assignment. The assembler 
assigns consecutive addresses to program elements 
as it encounters them. After processing each ele- 
ment, the assembler increments a counter by the 
number of words assigned to that element. This 
counter indicates the storage location available to 
the next element. 



Relocatable Programs. The assembler can produce 
object programs in a relocatable format; that is, a 
format that enables programs to be loaded and exe- 
cuted at storage locations different from those 
assigned when the programs were assembled. 

Convenient Data Representation. Constants can be 
specified as decimal digits, alphabetic characters, 
hexadecimal digits, and storage addresses. Conver- 
sion of the data into the appropriate machine format 
of the 1130 System is performed by the Assembler. 
Data can be in a form suitable for use in decimal 
integer, fixed-point, or real arithmetic operations. 

Program Listings. For every assembly, the user 
can obtain a program listing. This listing can be 
produced either off-line (Card/Paper Tape Assem- 
bler) or on-line during the assembly process (Disk 
Monitor Assembler). 

Error Checking . Source programs are examined by 
the Assembler for errors arising from incorrect use 
of the language. Where an error is detected, a coded 
warning message appears in the program listing. 
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SYMBOLIC LANGUAGE 



MNEMONIC CONCEPT 



Label Field (Columns 21-25) 



Symbolic programming may be defined as a method 
whereby names and symbols are used to write a pro- 
gram. The symbolic language includes a standard 
set of mnemonic operation codes. Mnemonic opera- 
tion codes are easier to remember than machine lan- 
guage codes because they are usually abbreviations 
for actual instruction descriptions. For example: 



Description 

Add 
Execute I/O 



Mnemonic 

A 
XIO 



Each IBM 1130 machine instruction has a cor- 
responding mnemonic operation code. In addition, 
there are some mnemonic codes that assign storage 
and others that allow the user to exercise control 
over the assembly process. 



FORMAT OF STATEMENTS 



The label field represents the machine location of 
either data or instructions. The field may be left 
blank, may contain an asterisk in column 21, or 
may be filled with a symbolic address, left-justified 
in the field. Only data or instructions that are re- 
ferred to elsewhere in the program need a label, 
although a label that is not further referred to is 
not an error. 

A label can consist of up to five alphameric 
characters, beginning at the leftmost position of the 
label field. A label is always a symbol and must 
therefore conform to the rules for symbols (see 
Symbols) . The example below shows the symbol 
ALPHA used as a label. 



ALPM.A 



Operatio 



\ s,r,a 
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A source program consists of a sequence of state- 
ments. These statements can be written on a stan- 
dard coding form (X26-5994) provided by IBM. The 
information on each line of the form (Figure 1) is 
punched into one card or paper tape record or en- 
tered from the keyboard. The first position on the 
form (21) corresponds to card column 21 or to the 
first character of the paper tape/keyboard record. 
Space is provided at the top of the coding form to 
identify the program; however, none of this informa- 
tion is punched into the statement cards. The first 
20 columns of an assembler source card must be 
blank. 

NOTE: Keyboard input is acceptable only with the 
Monitor 2 Programming System. 



Statement Fields 

An assembler statement is composed of one to seven 
fields: label field, operation field, format field, tag 
field, operand field, comments field, and identifica- 
tion sequence field. 



If the label field is left blank, it is ignored by 
the Assembler and has no effect on the assembled 
program. If column 21 contains an asterisk (*), the 
entire statement is treated as comments and appears 
only in the listing. If the field contains a symbolic 
name (label), and the statement represents a standard 
machine language operation (Add, Store, etc.), the 
value assigned to the label is the address of the 
assembled instruction, which is equal to the value of 
the Location Assignment Counter (see Location As- 
signment Counter) at the time the statement is en- 
countered by the Assembler. Values assigned to 
labels of the various assembler instructions are 
specified in the section entitled Assembler 
Instructions. 

Operation Field (Columns 27-30) 

Each machine instruction and assembler instruction 
has a unique mnemonic operation code associated 
with it. When a particular operation is to be repre- 
sented, its mnemonic code must be punched, left- 
justified, in columns 27-30 of the source statement 
record. 
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Figure 1. Coding Form 



Format Field (Column 32) 

The format field specifies the type of machine in- 
struction being represented and, in the use of short 
(one-word) instructions, how the displacement field 
is to be handled. Any one of four entries is per- 
mitted: two for short instructions, one for a direct 
long (two-word) instruction, and one for an in- 
directly-addressed long instruction. For conven- 
ience, these formats are referred to by the charact- 
er used to specify them, namely blank format, X 
format, L format, and I format. 



Blank Format. A blank in the format field (column 
32) signifies a short instruction except with some 
of the extended mnemonics provided with the Disk 
Monitor Assembler, in which case a blank format 



field specifies a long instruction. Bit 5 of the 
assembled instruction is set to zero. A blank also 
indicates that any expression in the operand field be 
interpreted as the desired effective address for the 
statement. 

During execution of certain short instructions, 
the effective address is the sum of the displacement 
(last 8 bits of the instruction word) and the contents 
of the Instruction Address Register (IAR). A blank 
format for such instructions causes the assembler to 
subtract the current value of the Location Assignment 
Counter from the expression in the operand field. 
Thus, when this result is added to the IAR during 
execution of the instruction, the correct effective 
address is obtained. 

The effective address of short Store Index (STX) 
instructions is always obtained by adding the dis- 
placement to the IAR. The displacement of the Load 



Index (LDX), Load Status (LDS), WAIT, all shift 
instructions, and all condition testing instructions 
is never added to the IAR. The effective address of 
all other short instructions is obtained by adding 
the displacement to the IAR, if the instructions are 
not indexed; that is, if column 33 is blank or zero. 

The X format suppresses the automatic subtraction 
of the address counter from the displacement operand 
value when the instruction is moved. Therefore, the 
X format should be used for a short instruction which 
will have an effective address obtained by adding the 
displacement to the IAR. This requirement is not in 
conflict with the relocation process, because the 
process shifts the whole program, including instruc- 
tions and reference data, to a core storage area 
different from'that for which it was assembled. The 
relative distances between instructions and data re- 
main the same, and the displacements remain correct. 

In a relocatable assembly, the expression speci- 
fying an operand modified by the IAR must be re- 
locatable so that the actual displacement is an ab- 
solute quantity (see Expressions) . If this rule is not 
followed, a relocation error will be indicated. Also, 
since displacements must lie in the range -128 
to +127 , the value of the displacement-specifying 
expression must not be more than 127 greater, 
nor more than 128 less than the address of the 
next location after trie instruction in which it appears; 
otherwise, an addressing error will be indicated. 
An example illustrating the blank format is shown 
below: 



Assume A = location 1000 
B = location 1050 



10 
10 



The value of the IAR will be 1001 when 
instruction A is executed. Therefore, the value 
computed by the assembler for the displacement 
will be 49 . 



In the case of an instruction whose address is 
not modified by the IAR, the Assembler interprets 
the expression in the operand field as the desired 
contents of the displacement field, without modifica- 
tion. In this case, the operand specifying the dis- 
placement must be absolute and must be in the range 
-128 to +127 , or relocation and addressing errors 
result. 

X Format. An X in the format field indicates to the 
Assembler that the related statement is to be assem- 
bled as a short instruction. It further indicates that 
any expression in the operand field is to be inter- 
preted as the desired displacement value. 

Consider the example illustrated in Figure 2; 
the purpose of this instruction sequence is to change 
the flow of a program by inserting a branch instruc- 
tion in a location that previously contained a "no 
operation. " If the branch instruction at BRCON 
were specified as MDX GO (i. e. , blank format), 
the assembler would compute the displacement 
on the basis of the IAR value of 1101. (The IAR 
would have a value of 1101 if the BRCON instruction 
were executed where it was assembled.) However, 
the programmer, knowing the instruction will be 
executed at location SWTCH, computes the dis- 
placement himself and specifies the X format. 

L Format. If column 32 contains the character L, it 
signifies a long (two-word) instruction with direct 
addressing. Bit 5 (F) of the assembled instruction 
is set to 1. The operand-field expression, which may 
be relocatable or absolute, is used to fill the second 
word (bits 16-31) of the assembled instruction. A 
second operand may be present, separated from the 
first operand by a comma (,). This operand may be 
used in one of two ways: 

1. To specify symbolic condition codes for use with 
BSC, BSI and BOSC instructions. 

2. To specify an expression that has a value in the 
range of -128 to +127 and is not relocatable. 
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This second operand yields bits to fill bit positions 
8-15 of the assembled instruction. 

I-Format. If column 32 contains the character I, it 
signifies an indirectly addressed long instruction. 
Bit 5 and bit 8 are set to 1. In all other respects 
an indirect instruction is treated exactly as a long 
direct instruction. If a displacement operand is 
specified, its high-order bit (bit 8) will always be 
a one, causing the displacement to be negative, 
because this bit is also the indirect flag bit. 
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Figure 2. Use of X Format 



Tag Field (Column 33) 

Column 33 is used to specify an index register if 
one is required. The code in column 33 is the index 
register number; i.e. , l=Index Register 1, 2=Index 
Register 2, and 3=Index Register 3. A zero or a 
blank indicates that no index register is to be used. 

If no tag is specified in an LDX, MDX, or STX 
instruction, the IAR is used. The example below 
shows an add instruction that addresses the core 
location whose address is zero plus the contents 
of Index Register 2. 
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Operands and Remarks Field (Columns 35-71) 

The operand field is used to specify subfields in in- 
structions and constants. The content of the operand 



field for the various instruction formats are de- 
scribed under Format Field. Blanks must not appear 
within the operand(s) except as character values or 
in the EBC statements. 

Some examples of one- and two-operand state- 
ments are shown in Figure 3. 

Remarks Field 

Remarks are for the convenience of the programmer. 
They permit lines or paragraphs of descriptive infor- 
mation about the program to be inserted in the pro- 
gram listing. Remarks appear only in the program 
listing; they have no effect on the assembled object 
program. Any valid characters (including blanks) 
can be used as remarks. 

The Remarks field must appear to the right of 
the operand field and must be separated from it by 
at least one blank. 

Comments Field 

By placing an asterisk in column 21, the combined 
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Figure 3. One- and Two-Operand Statements 



statement fields from columns 22-72 may be used 
for comments. The identification-sequence field 
(columns 73-80) should not be used for comments. 
If it is necessary to continue comments on ad- 
ditional lines, each line must have an asterisk in 
column 21, as illustrated in Figure 4. 

Identification-Sequence Field (Columns 73-80) 

The identification-sequence field may be used for 
program identification and statement- sequence num- 
bers. It is limited to columns 73-80. The informa- 
tion in this field normally is punched in every state- 
ment card. The Assembler, however, does not 
check this field. 



STATEMENT WRITING 

Symbolic language statements are accepted by the 
Assembler only if they conform to the rules of syntax 
presented in this section. Subsequent sections of this 
publication deal with the format and content of the 
specific types of assembler statements (machine in- 
structions and assembler instructions). Instructions 
of both types are formed by using the basic elements 
described here. Many of the points introduced in this 
section are covered more extensively in subsequent 
sections. 



Character Set 



The following characters may be used in statements: 



Monocase Alphabetics 

Numerics 

Special Characters 



A through Z, $, #, 
through 9 
/*+-=&|~"» <> 

'.,:;<)%-? 
(blank) 



The codes that the assembler accepts for these 
characters are listed in Appendix A. Appendix A 
also lists additional codes which may be used in com- 
ments statements, as character values, and as 
alphameric constants. The + and & special char- 
acters may be used interchangeably as operators. 



Symbols 

Storage areas, instructions, and other elements may 
be given symbolic names for the purpose of referring 
to them in the program. The symbolic name is called 
a symbol. It can contain up to five characters. 



While the first character of a symbol must be alpha- 
betic, the remainder may be alphabetic, numeric, or 
any combination of the two. No embedded blanks or 
special characters may be used. Any violation of 
these rules is detected by the Assembler and -indi- 
cated as an error in the program listing. 
The following are valid symbols: 



PUNCH 

A2345 



START 
LOOP 2 



N 
BC$#@ 



$, # and @ are monocase alphabetics, not special 
characters (see Character Set) , and as such can be 
used in the label field. 

The following symbols are invalid, for the 
reasons noted: 



256B 

RECORDAREA2 
END 1 



First character is not 

alphabetic 

More than 5 characters 

Contains a blank 



If a symbol is to be used as an operand, it must 
be defined in the program by using it as the label of 
a statement. Two types of label assignments are 
allowed. In machine-instruction statements and cer- 
tain assembler statements, the label is assigned an 
address equal to the current value of the Location 
Assignment Counter. In the Equate Symbol statement 
(see Symbol Definition Statement ) , the label is 
assigned the value specified in the operand of the 
statement. 

Symbol Table. For every program assembled, a 
table of the symbols in that program is created. 
This is the symbol table; each entry in the table re- 
cords the value and relocation property of a symbol. 

All symbols defined in the program are entered 
in the symbol table. Symbols that appear in the 
label field of assembler instructions that do not use 
labels (for example, ABS, END, ENT} are not placed 
in the symbol table. 

General Restrictions on the Use of Symbols. The 
following restrictions are imposed on the use of 
symbols : 

• A symbol may appear only once in a program 
as the label of a statement. If a symbol is used 
as a label more than once, only the first usage 
is recognized. Each subsequent usage of the 
symbol as a label is ignored and, in the card/ 
paper tape system, is noted as an error in the 
program listing. In addition, any reference to 
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OfMHVrfOfl 



*.t,h.e, Ms.r.e.* 



i 5 



HI 



Operandi & Kfivtorics 



/.*. .COX, .2.1. .MiA.K.t.S, ,T.H,f,S , .A. .COX/K.C.V.r.S, ,LJ.u,e t 



*.A.N, J l r.g/ 



S» .«.£, 9 M< /,*,£,£>> .f.fl.l. .if.W.g,^, .LJ.N.E. .O .F. .C.O.MJA.e.N.T ,$ t 



J I I I I I — I 1 — L. 



_I_J I l__l_ 



Figure 4. Example of Comments Statement 

such a symbol is noted as an error. 

• The number of symbols that can be defined in a 
program is restricted by the amount of core 
storage available to the assembler. The number 
of symbols allowed is defined in the system 
operator's manual. 



For example, in the sequence 



LA 



L.I 



&J. 



- 



5 J 



Operation 



4_ 



s. T .g, 



&. 



m 



B.t.T.fK. 



£iLSL*£x 



% Axl>.I>Ji.1 



LIAJ^. 



L \Of^i 



I 



LOCATION ASSIGNMENT COUNTER 

The Assembler maintains a counter to assign sequen- 
tial storage addresses to program statements. This 
counter is called the Location Assignment Counter. 
It always indicates the next available address. As 
each machine instruction is processed, the counter 
is incremented by the number of words assigned to 
that instruction. Certain assembler instructions 
also cause the Location Assignment Counter to be 
set or incremented, whereas others do not affect it 
(see Assembler Instructions) . 

Location Assignment Counter Overflow . The maxi- 
mum value of the Location Assignment Counter is 
65535, a 16-bit value. If a program being assem- 
bled causes the counter to be incremented beyond 
65535, the Assembler retains only the rightmost 
16 bits in the counter and continues the assembly, 
checking for any other source program errors. No 
usable object program is produced. The user can, 
however, still obtain a listing of the entire source 
program. 



RELATIVE ADDRESSING 

Once an instruction has been named by a symbol in 
the label field, it is possible for other instructions 
to refer to that instruction by using the same symbol. 
Moreover, it is possible to refer to instructions pre- 
ceding or following the instruction named by indica- 
ting their positions relative to that instruction. This 
procedure is referred to as relative addressing. A 
relative address is, effectively, a type of expression 
(see Expressions) . 



control can be transferred to the second instruction 
by either of the following instructions: 



Label 
21 25 




Operation 

27 30 




F 
32 


T 

33 


M 


35 40 


45 








B.S.C, 




L 




M 


SiT.A,£,T>+, f 1 i i i i i ii 
















l i i i i n i i i i « 1 i i 






B.S,C, 




L 






A, L.I ,S,/ , _ i3i i 


1111 


, , 


i 1 l l 




■ i i 










1 1 1 1 1 — 9 1 1- 


1 I 1 1 


1 1 



By using relative addressing, it is also possible 
to refer to a particular word within a block of re- 
served storage. For example, the instruction 



Pig iTi/Ii 



Ope rot loo 



&.ss, 



1 F 
I" 



i 






\SjQ_ 



■ ' i i i — i — 1_ 



a i 



■ i i i i i i i i i — i_j- 



reserves a block of 50 words, in which BETA is the 
address assigned to the first word in the block. The 
address BETA+1 then refers to the second word, 
BETA+2 to the third word, and BETA+n to the (nth+1) 
word. 

Relative addressing can also be effected by using 
the current value of the Location Assignment Counter 
in an operand. In symbolic language this value is 
denoted by an asterisk (*). (See The Asterisk Used 
as an E lement. ) 



SELF -DE FINING VALUES 

A self-defining value is a machine value or a bit 
configuration. 



Self-defining values can be used to specify such 
program elements as data, masks, addresses, and 
address increments. The type of representation 
selected (decimal, hexadecimal, or character) de- 
pends on what is being specified. 



Decimal Values 



combination of punches in a single card column, or 
a paper tape character that translates into the eight- 
bit IBM Extended BCD Interchange Code. Appen- 
dix A is a table of these combinations, their inter- 
change codes and, where applicable, their printer 
graphics. A period used as a character value is 
represented as two periods in sequence, (i. e. , . . ). 
Examples of character values are: 



A machine decimal value is an absolute number from 
to 65535. It is assembled as its binary equivalent. 
Some examples of decimal, self-defining values are 

500 003 

17 52324 

7230 1 

If a number larger than 65535 is specified in address 
arithmetic, the value is truncated modulo 65536; 
that is, only the low order 16 bits of the binary value 
are" retained. 

Hexadecimal Values 

A hexadecimal value is an unsigned hexadecimal 
number written as a sequence of digits. The digits 
must be preceded by a slash (/). The hexadecimal 
digits represent the 16 possible combinations of 
four bits . 

Each hexadecimal digit is assembled as its four 
bit value. The hexadecimal digits and their bit 
patterns are as follows: 

- 0000 4 - 0100 8 - 1000 C - 1100 

1 - 0001 5 - 0101 9 - 1001 D - 1101 

2 - 0010 6 - 0110 A - 1010 E - 1110 

3 - 0011 7 - 0111 B - 1011 F - 1111 

The following are examples of hexadecimal, 
self -defining values: 

/FFFF 

/AB12 

/379B 



/F2 
/00F2 



\ equivalent 



If more than four hexadecimal digits are speci- 
fied in one sequence, only the four low-order digits 
are retained by the assembler. If less than four 
hexadecimal digits are specified, they are entered, 
right-justified. 

A table for converting decimal values to hexa- 
decimal values is provided in Appendix B. 

Character Values 

A character value is a single character, preceded 
by a period. A character value may be a blank, any 



.A 

. 1 

. 2 

. D 

. (blank) 
The same value can frequently be represented 
by any one of the three types of self -defining values. 
For example, the decimal value 196 can be expressed 
in hexadecimal as /C4 and as a character, . D. The 
selection of a particular type of value is left to the 
programmer. Decimal values can be used for actual 
addresses and input/output unit numbers, hexadeci- 
mal values for masks, and character values for 
data. 



EXPRESSIONS 

The term "expression" refers to symbols or self- 
defining values used as operands, either singly or 
in arithmetic combinations. Expressions are used 
to specify the various fields of machine instructions. 
They are also used as the operands of assembler- 
instruction statements. 

An expression has three components: elements, 
terms, and operators. 

Elements 



The smallest component of an expression is an 
element. An element is either a single symbol or 
a single self -defining value. The following are 
valid elements: 

TMP 
/1A6 
.B 

A 

* 

4 
The Asterisk Used As an Element 

When used as an element the asterisk is relocatable 
and stands for the current value of the Location 
Assignment Counter for the instruction in which it 
appears (i. e. , the rightmost word of the current 
instruction + 1). Thus, the asterisk as an element 
can have different values for different instructions. 
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Lobal 

21 2i 




Op* ration 

27 30 




F 

3} 


T 

33 




33 40 43 






LA , 










AiB,C, i i i i i i i i i i i 


S.U.H , 




A. . . 










OtCF, ,,,,.,,.,.. 






S. . . 










OtAj,A, i i i i i i i i i i 






8.3.C, 




L 






S.UM..+ , , . , 


1111 




i i i 










• • •) 

i i i i i i i i i i i i i i 



The last instruction is a conditional branch to 
location SUM and can be written 



label 

21 23 




Operation 

27 3^ 




F 

32 


T 

33 




35 40 45 






B.S.C, 




L 








.,. ,1. 1 1 1 




i i i 










1 1 1 1 1 1 1 1 1 1 1 I 1 1 



Be sure the asterisk refers to the proper word when 
it is used with a long instruction or in an area where 
long instructions are present. In the previous exam- 
ple, the BBC instruction will become two machine 
language words after assembly. Therefore, during 
assembly of the BSC instruction, the Location As- 
signment Counter contains a value one greater than 
if the BSC were a short instruction. 



position of the asterisk always makes clear what is 
meant. Thus, **10 means "the value of the Location 
Assignment Counter multiplied by 10. " 

Evaluation of Expressions 

From a symbolically written operand, the evaluation 
procedure derives an integer value that can be used 
as (1) a displacement value in a short instruction, 
(2) an address in a long instruction, or (3) an absolute 
numeric quantity. 

An expression is evaluated as follows: 



1. 
2. 



3. 



Each element is replaced by its numeric value. 
Each term is evaluated by performing the indi- 
cated multiplications from left to right, in the 
order in which they occur. In multiplication, 
the low-order 16 bits are retained. 
The terms are combined from left to right, in 
the order in which they occur. If the result is 
negative, it is replaced by its 2's complement. 



Grouping of terms, by parentheses or otherwise, 
is not permitted; however, this restriction can often 
be circumvented. For example, the product of 25 
times the quantity B-C can be expressed as 



Terms 



25 * B - 25 * C 



A term can consist of a single element, two elements 
separated by an asterisk (which denotes multiplica- 
tion) , or three elements each separated by an asterisk, 
etc. A term must begin with an element and end 
with an element, but is not permissible to write two 
elements in succession. The following are valid 
terms: 

TMP * FUNC * TAXY 

A * 4 

X * Y* 5 

6 * 4096 

3 

Operators 

An operator is a character that denotes an arithmetic 
function. The recognized operators are + or & (plus 
or ampersand), - (minus), and * (asterisk), denoting 
addition, subtraction, and multiplication, respec- 
tively: An operator must be used between two terms. 
Two operators may not be used in succession. 

There is no ambiguity between the use of the 
asterisk as an element and the use of the asterisk 
as an operator to denote multiplication, because the 



Types of Expressions 

In addition to evaluating expressions, the Assembler 
must decide whether the expression is absolute 
or relocatable. Without this information the Assem- 
bler would be unable to assign the proper relocation 
indicator bits for use during loading. 

Rules for Determining the Type of Expression 

The rules by which the expression type is determined 
are: 

• A symbol that is defined by means of the Location 
Assignment Counter is a relocatable element. 

• Decimal and hexadecimal integers and character 
values are absolute elements. 

• A relocatable element alone is a relocatable 
expression. 

• A relocatable element, plus or minus an absolute 
element, is a relocatable expression. 
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• The difference of two relocatable elements is 
an absolute expression. 

• A symbol that has been equated to an expression 
(by means of the EQU assembler instruction) 
assumes the same relocation property as that 
expression. 

These rules are clarified by the following example: 

Assume that a programmer wishes to incorpor- 
ate a table into a relocatable program, and he knows 
that he may later wish to add or delete items with- 
out changing program references to the table. The 
first step is to assign symbols to the first (lowest- 
addressed) word in the table and to the location 
immediately after the last (highest-addressed) word 
of the table. These symbols could be BGTBL and 
ENTBL, respectively. Regardless of the number 
of items in the table or of the number of later 
additions or deletions, the number of words in the 
table is always equivalent to the value of the ex- 
pression ENTBL-BGTBL. This illustrates the rule 
that the difference of two relocatable elements is an 
absolute expression. 

Expanding this example, assume the programmer 
wishes to use a second table the same length as the 
first. The first (lowest addressed) word of the 
second table can be indicated by the symbol STBL. 
Then, the location following the last (highest-ad- 
dressed) word of the second table can be indicated 
by the expression 

STBL + ENTBL - BGTBL 

This address is subject to relocation; hence, the 
expression is relocatable, following the rule that a_ 
relocatable element plus or minus an absolu te 
element is a relocatable expression. 

Procedure for Determining the Type of Expression 

The following paragraphs describe the procedure 
for determining expression type (absolute or 
relocatable) : 

• Discard any term that contains only absolute 
elements. 

• Examine each term of the expression. If any 
term contains more than one relocatable ele- 
ment, the expression will yield a relocation 
error. 



• Replace each relocatable element by the symbol 
r, and replace each absolute element by its 
value. This yields a new expression which in- 
volves only numbers and the symbol r. 

• Rewrite the expression in simplest form by 
evaluating it according to the address arithmetic 
rules given above in the section, Evaluation of 
Expressions. 

If the result is an integer, the operand is absolute. 
If the result is r, the expression is relocatable. If 
the result contains r to any power other than one, or 
contains r with a coefficient other than one, the 
operand does not have a well-defined relocation 
property and will yield a relocation error. The 
following examples illustrate this procedure. 

NOTE: When the terms absolute symbol and reloca- 
table symbol are used in text, they mean symbols 
that refer to addresses. 

Example 1: Consider the expression, 

4+3*TRANS-2*FUNC+COUNT 

where TRANS and FUNC are relocatable symbols, 
and COUNT is an absolute symbol. Discarding the 
terms involving only absolute elements leaves 

3*TRANS-2*FUNC 

This does not contain any illegal terms. Replacing 
each symbol by the letter r results in 

3*r-2*r 

Evaluating this produces r; therefore, the expression 
is relocatable. 

Example 2: Consider the expression, 

2*3*TRANS-FUNC 

This reduces to 

2*3*r-r 



or 



5r 
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This is neither r nor a number; therefore, the 
expression will cause a relocation error. 

Example 3: Consider the expression, 

A*2*R-A*A*R+5 

where A is an absolute symbol, and R is a relocata- 
ble symbol. The expression is absolute if the value 
of A is zero or two and relocatable if the value of A 
is 1. If the value of A is anything else, a relocation 
error will result. 

In the following examples, A, B, C, and D are 
relocatable symbols, and J, K, L, M, and N are 
absolute symbols. 

Relocatable expressions: 



A 


1*A 


A+J 


250*A-249*B 


A+B+C-D-* 


100*A+50*B-75*C-74*D 



Absolute expressions: 



12345 
A-B+C-IM-5 



0*A 
500*A-400*B-100*C 



Relocation Errors 

If a source program contains an expression having in 
it one or more of the following, that expression is 
flagged as a relocation error. 

• The negative (complement) of a relocatable 
element 

• An absolute element minus a relocatable element 

• The sum of two relocatable elements 

In the following examples, A, B, C, and D are 
relocatable symbols, and J, K, L, M, and N are 
absolute symbols. 

A+B (+2r) A*B (r 2 ) 

-A (-lr) 2*A (2r) 

15-* (-lr) 5*A-6*A (-lr) 

A+J+M+N+B-C+IH-L(+2r) 

NOTE: In an absolute assembly headed by an ABS 
statement (described later), all symbols and asterisk 
values are defined as being absolute; therefore, no 
relocation errors are possible. 



I 
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MACHINE-INSTRUCTION STATEMENTS 



All machine instructions can be represented symbol- 
ically as assembler language statements. There are 
two basic formats: short and long. However, with- 
in each basic format, further variations are possible. 

The symbolic format of a machine instruction 
parallels, but does not duplicate, its actual format. 
A mnemonic operation code is written in the opera- 
tion field, and one or more operands are written in 
the operand field. Comments can be appended to a 
machine-instruction statement as previously ex- 
plained. 

Any machine-instruction statement can be named 
by a symbol, which other assembler statements can 
use as an operand. The value of the symbol is the 
address of the leftmost word assigned to the assem- 
bled instruction. 



Unique 
Character Condition 

O (Alpha) Overflow 



Carry 



Even 



+ or & Plus 



Minus 



Description 

Skip or do not branch 
if Overflow indicator £>ff 

Skip or do not branch 
if Carry indicator off 

Skip or do not branch 
if bit 15 of Ace =0 

Skip or do not branch 
if bit of the Ace =0 , 
but not all bits of Ace 
=0 

Skip or do not branch 
if bit of Ace =1 



Bit Position 
Set to 1 



15 



14 



13 



12 



11 



MNEMONICS 



Zero 



Skip or do not branch 
if all bits of Ace =0 
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A list of all IBM 1130 machine language instructions 
and their associated mnemonics, including those 
mnemonics available for the monitor system only, is 
given in Table 1. 

Condition-Testing Instructions (BSC, BOSC, BSI) 

The machine instructions Branch or Skip on Condition 
(BSC), Branch Out or Skip on Condition (BOSC), 
and the long form of Branch and Store Instruction 
counter (BSI) use bits 10-15 of the displacement to 
test any combination of six conditions associated with 
the accumulator. When coding these instructions, the 
user does not use an expression to specify the dis- 
placement field, but, instead, writes a series of 
unique characters, each of which represents one bit 
of the condition-testing mask. These character 
symbols may be written in any combination; the bits 
they represent are combined by the assembler in a 
logical OR fashion. The symbols and their repre- 
sentations are: 



Examples: 



Operofio 



B.S.C 



3.S.C 



i S.S.C 



3.S.C, 



&&C, 



B.S.C 



0,S,C 



B\S , C t 



B.S.I 



M 



\L 



m 



— m 



1 



iMiJ 



H — ' — ' — "- 



8 *- . . 



i 



M 



+, 



».-■ 



C. , , 



I frX./.i 



an 



*. » , * ■ +■ 



S,U,B,R, 



Ol 



Skip on plus condition 

Skip on non-zero (plus or minus) 

Skip on non-plus (zero or minus) 

Skip if Carry indicator off 

Branch to EXIT if nor plus 
(zero or minus) 

Branch to EXIT if zero 
(not plus or minus) 

Unconditional Branch to EXIT 

Branch to the contents of XR1 if minus 
(not zero or plus) 

Branch and Store instruction counter 
to SUBR if Overflow is on 
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Table 1. Machine Instruction Mnemonics 



Mnemonic 




OP Code 


, Instruction 




Load and Store 


(Hexadecimal Represen 


ration) 








LD 




COO 


Lood Accumulator 




LDD 




C80 


Load Double 




LDX 




600 


Load Index 




LDS* 




200 


Load Status 




STO 




D00 


Store Accumulator 




STD 




D80 


Store Double 




STX 




680 


Store Index 




STS 




280 


Store Status 




Arithmetic 










A 




800 


Add 




AD 




880 


Add Double 




S 




900 


Subtract 




SD 




980 


Subtract Double 




M 




A00 


Multiply 




D 




A80 


Divide 




AND 




E00 


And 




OR 




E80 


Or 




EOR 




F00 


Exclusive Or 




MDM 


t5 


740 


Modify Memory 




Branch 










B 


t4 


700 or 4C0 


Branch 




BSI 




400 


Branch and Store Instruction Counter 




BSC 




480 


Branch or Skip Conditionally 




BP 


t6 


4C30 


Branch Accumulator Positive 




BNP 


+6 


4C03 


Branch Accumulator Not Positive 




BN 


■to 


4C28 


Branch Accumulator Negative 




BNN 


■to 


4C10 


Branch Accumulator Not Negative 




BZ 


•to 


4C18 


Branch Accumulator Zero 




BNZ 


t6 


4C20 


Branch Accumulator Not Zero 




BC 


+6 


4C02 


Branch on Carry 




BO 


t6 


4C0I 


Branch on Overflow 




BOD 


+6 


4C04 


Branch Accumulator Odd 




SKP* 


t 


480 


Skip on Condition(s) 




BOSC 


2 


484 


Branch Out or Skip Conditionally 




MDX 




700 


Modify Index and Skip 




Shift 










SLA* 




100 


Shift Left Accumulator 




SLT* 




108 


Shift Left Accumulator and Extension 




SLC* 




10C 


Shift Left and Count Accumulator and Extens 


on 


SLCA* 




104 


Shift Left and Count Accumulator 




SRA* 




180 


Shift Right Accumulator 




SRT* 




188 


Shift Right Accumulator and Extension 




RTE* 




18C 


Rotate Right 




XCH* 


t3 


18D 


Exchange Accumulator and Extension 




Input/Output 








XIO 




080 


Execute I/O 




3 
Miscellaneous 








NOP* 




100 


No Operation 




WAIT* 




300 


Wait 
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*Valid in short format only 

tNot included in card/paper tape Assembler or DM1 Assembler. 

1 . The hexadecimal representation of the machine operation code is derived from the instruction format in the manner shown below. 
Bits 6 and 7 are assumed to be zeros because they do not enter into the makeup of any operation codes. 

2 . Same as BSC with Bit 9 set to one . 

3. An operand should not be specified. 

4. When branch is short (Blank or X format), this operation code is assembled as an MDX (700). If the branch is long (L or I format), 
this operation code is assembled as a BSC with Bit 5 set to one (4C0). 

5. This instruction is automatically assembled as a long instruction (L is not required in the format field). Note that an attempt to use 
indirect addressing will result in a syntax error. Indexing is not permitted with this extended operation code. 

6. Extended conditional branch operation codes are assembled automatically as long instructions. ( L is not required in the format field). 
Note that the proper condition code bits are preset, and further condition bits may not be specified following the operand. 

Hexadecimal Characters 



OP Code 
Format (F^ 



Index Tag bits (T) 




IA bit, part of 
displacement, or extension 
of OP code 



Part of displacement, 
or extension of OP code 

Condition indicators, 
or part of displacement 
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ADDITIONAL MONITOR SYSTEM MNEMONICS (DM2) 

Several new mnemonic operation codes which are 
equivalent to a Branch or Skip on Condition (BSC) may 
be used with the DM2 System. The operation code 
to be used for a specific job depends on the format 
and condition code required . 

A new mnemonic MDM has been introduced that 
may be used in place of an unindexed MDX long. 
XCH may be used in place of RTE 16. 

Examples of the additional DM2 System 

mnemonics are shown in Table 2. The mnemonics 
are listed below. 

Skip on Condition (SKP). The condition codes (+, -, 
Z, E, O, and C) are specified as with a short BSC 
instruction. This instruction must not be indexed. 

Branch Unconditionally (B). If the Format field con- 
tains an L or I, the BSC operation code is used with 
bit 5 set to one. Condition codes are not allowed 
after the address expression in the Operand field. 
If the Format field is left blank or contains an X, 
the MDX operation code is used, and the expression 
in the Operand field is used to form the displacement. 



Branch Accumulator Zero (BZ). Condition codes for 
accumulator positive (+) and accumulator negative 
(-) are set to one. 

Branch Accumulator Not Zero (BNZ) . Condition code 
for accumulator zero (Z) is set to one. 

Branch on Carry (BC). Condition code for Carry 
indicator off (C) is set to one. 

Branch on Overflow (BO) . Condition code for Over- 
flow indicator off (O) is set to one. 

Branch Accumulator Odd (BOD). Condition code for 
accumulator even (E) is set to one. 

NOTE : Condition codes may not be used with any of 
the above instructions, except SKP, since the condi- 
tion code is implicit in the extended mnemonic. The 
conditional branch instructions (all except SKP and 
B) are always assembled as long instructions; thus, 
the Format field need not contain an L, although the 
instruction is not classed as an error if L is speci- 
fied. Indirect addressing may be specified. 



Branch Accumulator Positive (BP) . Condition codes 
for accumulator zero (Z) and accumulator negative 
(-) are set to one. 

Branch Accumulator Not Positive (BNP). Condition 
code for accumulator positive (+) is set to one. 



Branch Accumulator Negative (BN), Condition codes 
for accumulator zero (Z) and accumulator positive 
(+) are set to one. 



Branch Accumulator Not Negative (BNN) . Condition 
code for accumulator negative (-) is set to one. 



Modify Memory (MDM). Contents of the location 
specified by the first operand is incremented or 
decremented by the value of the second operand. The 
second operand must be in the range -128 to +127. 

NOTE: This instruction is always assembled as a 
long instruction; thus, the Format field need not 
contain an L, although the instruction is not classed 
as an error if L is specified. Indexing and indirect 
addressing must not be specified. If the operand 
becomes zero or changes sign, the next word in the 
program will be skipped. 

Exchange Accumulator and Extension (XCH). Ex- 



change is identical to a RTE of 16. 
specified with this instruction. 



No operand is 
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Table 2. Examples of New (Extended) Machine Instruction Mnemonics (DM2 only) 





New Instr 


uc 


tic 


>n 


St 


atements 

m 


iquivalen 

27 30 


tS 


to 

J? 


ten 

13 


ie 


lts Operations Performed 

35 40 


ill 


.<>,X,P 










+, 








H5d 










*.,.... 


. i Skip if accumulator is positive 


11 














i i i i i i 
























SjtP 


> 










+x- 








ESC, 










*" 


i j Skip if accumulator is non-zero 


• 




































III 


3.KP 












z 








■ff,S£, 








j!i 


fi-^L-J-l-l-. 


__!__£_ Skip if accumulator is zero 


II 
































1 1 1 1 1 1 






pAp 












0, , , , , , 








8,S,<?, 










ft .... . 


i i Skip if Overflow indicator is off 


p 
































1 1 1 1 1 1 




jHS 


\skf 










••*;• 










8,Sd, 












, f Skip if Carry indicator is off 


































■ I , I 1 1 




Ii 


5XP 












*.-,£, , , . 








8,S,£, 










■*"l"~idi. l i ._!._ 


, i Skip if accumulator is non-zero or if Carry indicator is off 
































H-? 


1 i i l , 1 






7f, , 












f.XX-77 , , 








MDX, 










FiXiHX i i 


, , Branch unconditionally to EXIT, where EXIT must be within normal 




















1 
















displacement range. 




, , 






























i i , , i i 






K , 






L 






AtL,PM , ■ 








■RSZ 




L 






y«i_,/?A'. , , 


i i i Branch unconditionally to AI.PH 








































S2, 












7?,£, TA , . 








&sA 




I 






si:r>*, ; ,¥,- 


, i Branch to BETA if accumulator is zero 




















, 




















/57V 












B^Tl^. , . 








XS^f, 




L 






2.^,77/4, ,2.+ 


, , Branch to BETA if accumulator is negative 




, 




































SWZ 






T 






7l,^T,A , ■ 








B.S.C, 




I 






»£-,r^ v ,z, 


, , Branch indirectly to BETA (i.e., the address specified by contents of 




















, 














1 1 1 1 1 1 


BETA) if accumulator is non-zero 
















■ i i i i i 
















:j:£ 


1 1 , 1 ,1 






&4^ 












ftTMA , . 




, 




KS.d 




L 






tf7,Mv*i r 2.+ 


, f Branch to RTNA if accumulator is negative 
















i i i i i i 




, 














1 1 1 1 1 1 


, , 






















■BS.& 




L 






ZT/JZ,,-, 


i , Branch to RTNB if accumulator is non-negative (zero or positive) 




















1 . I 1 1 i 






y,/? 












5,U,8,Q , . 






ffstl 




L 






SM&£2, Z- 


, , Branch to SUB@ if accumulator is positive 






















iii 










iiitii 






#./? 






T 






5,//,a^ , , 




ii 


B&A 




I 






5i//.A^.,Z- 


, | Branch indirectly to SUBS (i.e. , the address specified by the contents of 




















H 












1 i i i i 1 


SUB$) if accumulator is positive 




tfyVf/ 5 












5.//£# , , 




it 


M£ 




I 






5". #£#,,*. 


, , Branch to SUB* if accumulator is non-positive (zero or negative) 




















! : ' 


i i i 










i i i i , i 






^ 












EMT.A-hlx 






ff,3£, 




L 






firV. ?;>£*.*■> 


£, | Branch to ENTR+1 if Carry indicator is on 


• 


















1 r 


1 1 1 










1 I 1 I 1 1 






#/?, 






T 


; 




<R , , , , i 






55/., 




I 


lZ 




d,,tf ! . • 


, , Branch indirectly to address specified by contents of index register 1 




















L_L !~J 


i i i 










1 1 1 1 1 1 


if Carry indicator is on 




















1 


• , i 










1 1 1 1 1 1 






y?,o, 








^ 




5 




, l 


££&_ 




L 


2 


% 


5.^,0, , , , 


, , Branch to address specified by contents of index register 2 plus 5 if 




















I 


i t . 


:?* 








1 I 1 1 1 1 


Overflow indicator is on 




















, 


« i i 








si 


1 1 1 1 1 1 






Ro,D 












rf^,/-,£, , , 






BSA, 




L 






faj r &,x& 


, , Branch to $AFE if accumulator is odd 




















' 


i i i 








l»H 


1 1 1 1 , 1 






MJM 












StAV'dj i+*5 




i iiii 


tf,0,X. 




L 






5V4,M,,i*iS 


, , Increment contents of core location SAVA by 5 


















i i li 


. i. i i 










■ i i i i i 






MD>M 




Is 








/.1J>.LA 7> 1 


M I 


^,/>,X, 




L 






/.\,L\D\tkA\ f tM 


S,0 [ Increment contents of core location /1D6A by 100 decimal 




















1 1 1 










■ , i i i i 






M,D,M 












4 lfl -J2, , 


§ 


/MX, 


«- 


L 






Aij,~ili2, i 


, , Decrement contents of core location A by 12 




















1 1 1 








Si- 


i i , i ii 






*£A 
















/77*i 










jfifri i i ii 


, . Exchange the accumulator and extension (rotate right 16) 














m 















I 
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ASSEMBLER INSTRUCTIONS 



Just as machine instructions are requests to the 
computer to perform a sequence of operations during 
program execution, assembler instructions are 
requests to the Assembler to perform certain opera- 
tions during the assembly. In contrast to machine - 
instruction statements, assembler-instruction state- 
ments do not always cause machine instructions to 
be included in the assembled program. Some, such 
as BSS and BES, generate no instructions but do 
cause storage areas to be set aside for constants and 
other data. Others (e.g., EQU) are effective only 
during the assembly; they may or may not generate 
something in the assembled program. If nothing is 
generated, the Location Assignment Counter is not 
affected. 

The following is a list of all assembler statements 
permitted by the IBM 1130 Card/Paper Tape Assembler. 
These statements are also valid for the Monitor 
Assembler. Additional statements are provided for 
the Monitor Assembler and are listed in the section 
Monitor Assembler Statements. 

Program Control 

ABS - Absolute Assembly 

1IBR - Transfer Vector Subroutine 

SPR - Standard Precision 

EPR - Extended Precision 

ORG - Define Origin 

END - End of Source Program 
Data Definition 

DC - Define Constant 

DEC - Decimal Data 

XFLC - Extended Floating Constant 

EBC - Extended Binary Coded Information 

Storage Allocation 

BSS - Block Started by Symbol 

BES - Block Ended by Symbol 

Symbol Definition 

EQU - Equate Symbol 

Program Linking 

ENT - Define Subroutine Entry Point 

ISS - Define Interrupt Service Entry Point 

ILS - Define Interrupt Level Subroutine 

CALL - Call Subroutine (2-word call) 

LIBF - Call Subroutine (1-word call) 

PROGRAM CONTROL STATEMENTS 

Program control statements are used to set the Lo- 
cation Assignment Counter to a specific value, to 
define the end of a source program, or to specify 
whether a particular program is to be assembled as 
absolute or relocatable. None of these assembler 
statements generate machine-language instructions 
or constants in the object program. 



ABS — Assemble Absolute 

An ABS statement is used to specify that a main pro- 
gram is to be assembled as an absolute program. 
An absolute program is one in which the core loca- 
tions used at execute time are the same as those 
specified by the programmer in the source program. 
The ABS statement is punched as shown below and 
is then used as the first statement of a source pro- 
gram. ' 



Label 
21 25 




Operation 

27 30 




F 

32 


T 
33 




35 40 45 






A.B.S, 












1_ 1 1 1 




i i i 










1 1 1 1 1 1 1 1 i 1 1 1 1 1 



If the first (non-comment) statement of a source pro- 
gram is not an ABS statement, the program will be 
assembled as relocatable. In an absolute assembly 
headed by an ABS statement, all symbols and aster- 
isk values are defined as absolute quantities ; there- 
fore, no relocation errors are possible. The 
significance of relocatable and absolute assemblies 
is explained in the following paragraphs . 

Relocatable Assembly 

Some programs assembled by the IBM 1130 Assem- 
bler are absolute; that is, the locations of assembled 
instructions are known during the assembly and the lo- 
cation on the listing is the actual location where a 
particular word is loaded. However, subroutines 
used by an absolute program must be in such a form 
that they may be loaded at various locations; other- 
wise, it would be necessary for the user to reassem- 
ble the subroutines each time he assembled a main 
program that required them. Therefore, all subrou- 
tines must be and main programs may be assembled 
relocatable. 

Every relocatable program or subroutine pro- 
duced by the IBM 1130 Assembler is assembled as 
though it begins at location zero. Since a job to be 
executed may contain several subroutines, it is 
obvious that they cannot all be loaded into locations 
starting with location zero. In fact, no relocatable 
program is ever loaded at location zero; instead, 
each program is relocated. The relocatable main 
program is loaded into the first available location. 
Subroutines are then loaded into successively higher 
locations of core storage, each beginning with the 
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next even location after the last core storage 
location used by the preceding subroutine. When 
a particular program has been loaded, the address 
of the first word is called the load address for 
that program. 

Thus, the address in core storage actually oc- 
cupied by an instruction of the program is the address 
assigned to that instruction during assembly, plus 
the load address of that program. To keep the pro- 
gram self -consistent, the load address must be add- 
ed to the address of many (but not all) 2-word in- 
structions, and those constants whose values are 
relocatable. 

This process of conditionally adding the load 
address is performed by the loading program before 
execution and is called relocation. In relocating in- 
structions, the loading program is guided by relo- 
cation indicator bits which are a part of the object 
program. 



If used, the SPR or EPR statement must follow 
the ABS or LIBR statement. If no ABS or LB3R 
statement is used, the SPR or EPR statement is the 
first statement in the program. 

ORG — Define Origin 

This assembler instruction is used to set the Location 
Assignment Counter (i.e. , the next location to be 
assigned) to any desired value. In this way the pro- 
grammer is able to control the assignment of storage 
to instructions , constants , and data . If a Define 
Origin statement is not the first entry in an absolute 
source program, the processor begins the assign- 
ment of storage at a location compatible with the size 
of the applicable loader (Card/Paper Tape Assem- 
bler) or the size of the resident monitor plus DISKN 
(Disk Monitor Assembler). A typical Define Origin 
statement is shown below. 



Absolute Assembly 



The programmer uses the ORG assembler statement 
in his source program to specify the locations into 
which the object program resulting from an 
absolute assembly is loaded. Subroutines are 
loaded into successively higher even-core locations 
following the end of the main program. 

Only main programs may be assembled absolute; 
subroutines must be assembled relocatable. 

LIBR — Transfer Vector Subroutine 

An LIBR statement is used as the first statement of 
a subroutine to specify that the subroutine is to be 
called by LD3F statements only (see Program- 
Linking Statements). The absence of an LIBR state- 
ment specifies that the subroutine is to be called by 
CALL statements only. LIBR statements are for sub- 
routines only, as ABS statements are for main pro- 
grams only. An LIBR statement needs no operands. 

SPR - Standard Precision, EPR - Extended 
Precision 

The SPR or EPR statement specifies that the pro- 
gram (main or subroutine) in which it appears uses 
standard precision or extended precision, respec- 
tively, for arithmetic operations. If these state- 
ments are included in the user's programs, the 
loader ensures that main programs and subroutines 
always match with regard to precision. Their use 
is optional, however. 



label 

21 25 




Operation 
27 X 




f 

32 


T 

33 




33 40 45 






0,R,G, 










3,0,0,0 i i i i i i 


1 l 1 i 














i i i i i ■ i i i i i i i i 



The label, if used, is assigned a value equal to the 
value of the Location Assignment Counter at the time 
the statement is encountered in the source program. 
(This assignment is made before the counter is 
modified.) If any symbols are used in the expression, 
they must have been previously defined. In a relo- 
catable assembly, an absolute expression in the oper- 
and field is considered a relocation error and the 
statement is ignored. 

Some examples of Define Origin statements are 
given below: 



Label 

21 25 




Operation 
27 30 




F 

32 


T 

33 




Ope, 

33 40 43 30 






0,#.G, 










Xi*/,Zi i i i i i i i i i i i i i 
















1 1 1 1 1 ■ 1 1 1 1 1 1 1 1 i 1 


S,T t A,/Z,T 




o./e.G, 










XM.Z.+.S.O. 






■ i i 










i i i i i i i i i i i i i i i i 


S,T,A,je,T 




O,/?, G, 










# t +.5,o. ,1,0, c, .c.T./e.+.ffitf. . 


i i i i 




i i i 










i i i i i i i i i i i i i i i i 



If the label XYZ has been previously defined as 
1000-lo tne f irst en try directs the assembler to begin 
the assignment of succeeding entries at location 1000. 
The second entry directs the Assembler to begin the 
assignment of succeeding entries 50 core locations 
beyond the location that has been assigned to the 
symbol XYZ. The third entry directs the Assembler 
to begin the assignment of succeeding entries at the 



18 



address specified by the current address of the Lo- 
cation Assignment Counter plus 50. 

END — End of Source Program 

An END statement is the last statement of a source 
program; it indicates to the assembler that all state- 
ments of the source program have been processed. 
An END statement is also used to define the execution 
address of the main program. To do this, the END 
statement requires an operand that represents the 
starting address of the program. At the completion 
of loading, execution begins at the address specified 
by the operand. For subroutines, all entry points 
are specified by ENT statements (described later); 
therefore, the operand of the END statement for a 
subroutine is blank. 

The following statements illustrate both types of 
END statements. 



Label 

21 25 




Operation 

27 30 




F 

32 


T 

33 




Operandi 

35 40 45 50 


r/iTiXi 






D.C. , 










/iE>FJ,F, xH l E l K CxOMSJ, i . 


i i i 
























D,E,C, 






p.c 












-i3 


8,5, 


/>,£",<:, i/|A/,7. 6.£,^i i . 


























A.L.P.H 


A 




o.c 












.,B 


,C,H 


AiR. ,C,0,NiS,T, i , . , 


























A.D.D.R 


S 




O.C 


( 










Ait 


P,ff,A 


*».*>■ ,A,D,D t R, ,C,0,N t , 


i i i 






, 


1 












i t 


I i i i i i i i i i i i 



DEC — Decimal Data 

The Decimal Data statement is used to enter binary 
data, expressed in decimal form, into a program. 
One DEC statement generates two 16-bit words of 
binary information. The format of the DEC statement 
is as follows: 



Label 

21 25 




Operation 

27 » 




F 

12 


T 

33 




Ooei 

33 40 45 50 






E.hl.O, 










.E.N.D, ,O.P, ,P,RM,R,flM . 
















i i i i i ■ i i i i i i i i i i 






e.m.o. 










G.O. ,3.P,A,A/,C.ti, ,7/>, ,6,0, , 






1 1 1 










i i i i i i i i i i i i i i i i 



DATA DEFINITION STATEMENTS 

Data Definition statements are used to enter data con- 
stants into storage. The statements can be named by 
symbols so that other program statements can refer 
to the fields generated. Any type of data definition 
statement can be used in standard or extended pre- 
cision program. 

DC — Define Constant 

The Define Constant statement is for generating con- 
stant data in main storage. Data can be specified as 
characters, hexadecimal numbers, decimal numbers, 
storage addresses, or any valid expression. One 16- 
bit word is generated for each DC statement. The 
format of this statement is shown below: 



LJ,8 l £ i l M P,£,C 



Ope rat i< 



Operandi & Rei 



Dte^cAMSx /, ,fla,t«e, J,t,e,n , ■ 



If a label is used, its value is equal to the current 
value of the Location Assignment Counter if the cur- 
rent value is even; if the current value is odd, the 
label will be equal to the current value plus one. The 
label is assigned to the leftmost word of the generated 
constant. The types of data permitted in the operand 
field are described in the paragraphs entitled Decimal 
Data Items . An example of a DEC statement follows: 



Label 

21 25 




Operation 

27 30 




f 

32 


T 
33 




35 40 45 


O.A.T.A. 




P.E.C, 












i i i i 




■ i i 










1 I I I 1 1 1 1 1 1 1 1 1 1 



K the value of the Location Assignment Counter is 
1000 when the DEC statement is encountered, the two 
words in storage look like this: 



Label 

21 25 




Operation 

27 30 




F 

32 


T 

33 




IS 40 45 


l.a.s.e.l 




O.C. . 










A.A/. .E.x.p^.e.s,s./ t oM. , 


i i i i 




1 1 1 










1 1 1 1 1 1 1 1 1 1 1 1 1 J_ 



If a label is used, the address assigned to it is the 
location of the generated data word and is equal to 
the current value of the Location Assignment Counter. 
Some examples of DC statements follow: 



Location 



01000 
01001 



Contents in Hexadecimal Form 

0000 
0013 



Decimal Data Items 

A decimal data item is used to specify, in decimal 
form, two or three words of data to be converted into 
binary form. Decimal data items are used in the 
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operand field of DEC assembler statements. Three 
types of decimal -data items are permitted: decimal 
integers, real numbers, and fixed-point numbers. 
A real decimal-data item can also be used as the 
operand of an XFLC statement that generates a 
3 -word constant. 

Decimal Integers . A decimal integer is composed of 
a series of numeric digits with or without a preceding 
plus or minus sign. The allowable range of decimal 
integers is -(231-1) to 231-1. 



Word 1 
4800 



Word 2 

0083 



Examples 



Decimal Integer 
50 
1535 
-3729 



Stored As 

00000032i6 

000005FF, , 

id 

FFFFF16F 16 

(2's complement) 



Real Numbers. A real number has two components: 
a mantissa and an exponent. 

• Mantissa — The mantissa is a signed or unsigned 
decimal number, which can be written with or 
without a decimal point. The decimal point can 
appear at the beginning, at the end, or within 
the decimal number. If the exponent (see below) 
is present, the decimal point can be omitted, 

in which case it is assumed to be located at the 
right-hand end of the decimal number. 

• Exponent — The exponent consists of the letter 
E,followed by a signed or unsigned decimal in- 
teger. The exponent part can be omitted if the 
mantissa contains a decimal point. If used, 

it must follow the mantissa. 



A real number is converted to a normalized, real 
binary number. The exponent part, if present, 
specifies a power of ten by which the mantissa is 
multiplied during conversion. For example, all of 
the following real numbers are equivalent and will be 
converted to the same real binary number. 

4.500 
45.00E-1 
4500E-3 
.4500E1 



The DEC assembler instruction stores real 
numbers in the standard precision real number 
format described in the system subroutine library 
manual. 

Fixed Point Numbers . A fixed-point number can 
have up to three components: a mantissa, an exponent, 
and a binary -point identifier. 

• Mantissa - The mantissa is the same as describ- 
ed for real numbers. 

• Exponent — The exponent is the same as describ- 
ed for real numbers. 



• Binary-Point Identifier — This identifier consists 
of the letter B, followed by a signed or unsigned 
decimal integer . The binary-point identifier 
must be present in a fixed-point number and 
must come after the mantissa. If the number has 
an exponent, the binary point identifier may 
precede or follow the exponent. 

A fixed-point number is converted to a fixed- 
point binary number that contains an understood binary 
point. The purpose of the binary-point identifier of 
the number is to specify the location of this under- 
stood binary point within the word. The number that 
follows the letter B specifies the number of binary 
places in the word to the left of the binary point (that 
is, the number of integral places in the word). The 
sign bit is not counted. Thus, a binary-point identi- 
fier of zero specifies a 31-bit binary fraction. B2 
specifies two integral places and 29 fractional places . 
B31 specifies a binary integer. B-2 specifies a binary 
point located two places to the left of the leftmost bit 
of the word; that is, the word would contain the low- 
order 31 bits of binary fraction. As with real 
numbers, the exponent, if present, specifies a 
power of ten by which the mantissa is multiplied during 
conversion. 

A fixed-point number preceded by a minus sign 
is stored in 2's complement form. 

The following fixed-point numbers all specify the 
same configuration of bits, but not all of them specify 
the same location for the understood binary point: 



I 



In standard precision, the above real numbers are 
converted and stored in two consecutive storage 
locations as follows: 



22.5B5 

11.25B4 

1125B4E-2 
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1125E-2B4 
9B7E1 

All of the above fixed-point numbers are con- 
verted to the same binary configuration, whose 
hexadecimal representation is: 



Word 1 
5A00 



Word 2 
0000 



XFLC - Extended Real Constant 

The XFLC assembler instruction is used to introduce 
into a program an extended precision real constant, 
expressed in three consecutive data words. When 
assembled, this instruction produces a format 
identical to the extended range real format describ- 
ed in the system subroutine library manual. 

The format of the XFLC instruction is shown 
below: 



Label 

21 25 


w 


Operation 

27 30 


H 


F 


T 

33 


iij 


Operandi & Rer 

35 40 45 50 


L,A,B,£,L 




X,F,L,C 










R t E,A,L, MUMB.EK, ■ 








i 












:•& 















The label is optional; if it is used, it is assigned to 
the location of the leftmost word generated. 

Some examples of the XFLC instruction are 
shown below: 



Label 

21 25 


I 


Operation 

27 30 


;f? 


F 


T 

33 




Operandi & Ret 

35 40 45 50 






X,F.L,C 










0... 5,3,1, Z J 


















R£,A,L 




X.F.L.C 










-J..,5,3,i t 2,S, , , . , 






















X.F.LC 










Sx.J,Z.£ t Z 


■ ' ' — i— 


+•¥ 




Is 








i i i i i i i i i i i i i i 



The data (in hexadecimal form) generated by each of 
these examples is 



1. 
2. 
3. 



Word 1 
0080 

Word 1 
0080 

Word 1 
008A 



Word 2 
4400 

Word 2 
BC00 

Word 2 
4000 



Word 3 
0000 

Word 3 
0000 

Word 3 
0000 



EBC — Extended Binary Coded Information 

The EBC statement is used to generate data words, 
each consisting of two 8-bit characters in the Extend- 
ed BCD Interchange Code (see Appendix A ). Up to 18 
sixteen-bit words can be generated with one EBC 
statement. The format of the statement is shown 
below: 



Label 

21 25 




Operation 

27 30 




F 

32 


T 

33 




35 40 45 


l.A.BJ, 




£.b.c, 










../U,P,//,/4. .O.A.T.At., , , 


i i i i 




i i i 










„l J...I 1 i .1 1 ~J_ ». -L J L 1 J 



If a label is present, it is assigned to the location of 
the leftmost word generated. The operand field con- 
tains the alphameric data to be represented in stor- 
age. This data must begin and end with a period. 
The data can be any valid character in the Extended 
BCD Interchange Code, including the period. 

Examples 



Label 
21 25 




Operation 

27 30 




F 

32 


T 

33 




35 40 45 


C.OMSJ 




e.B.c, 










..f.tf./P.Oitf ■ 
















1 1 111111 1 


A.L,P,H,A 




E.B.C. 










.tCO.A/.SJiAMT 


i i i i 




1 1 1 










i i i i i i i i i i i i i i 



The first example generates three words of data, with 
the location of the label CONST assigned to the left- 
most location of the first word generated. 



CONST- 



Word 1 
C5D9 

J 



Word 2 
D9D6 



Word 3 
D940 



Note that if the constant has an odd number of char- 
acters, as in the above example, the last word of 
data ends with the 8 -bit equivalent of blank. 

The second example generates four words of 
data: 



Word 1 
C3D6 



Word 2 
D5E2 



Word 3 
E3C1 



Word 4 
D5E3 



NOTE: Aperiod may not appear in the remarks 
field of an EBC instruction. 
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STORAGE ALLOCATION STATEMENTS 

Storage allocation statements are used to reserve 
blocks of storage for data or work areas . Two such 
statements are available with the IBM 1130 Assem- 
bler: Block Started by Symbol and Block Ended by 
Symbol . 

BSS — Block Started by Symbol 



Label 

21 25 




Operation 

27 30 




F 

32 


T 

33 




15 *0 45 






o.je.G, 










3t0,0,0 iiii 


/},/?.£",/}, 




B.S.S. 










2 l& i i i i i i i i i I I i i 






i i i 










1 1 1 1 1 1 1 1 1 1 1 1 1 !_._ 



BES — Block Ended by Symbol 



The BSS assembler instruction is used to reserve an 
area of core storage, within a program, for data 
storage or for working space. The format of the 
BSS instruction follows : 



Label 

21 25 




Operation 
27 30 




F 

32 


T 
33 




Operandi & Rei 

35 40 45 50 


LA,&£,L 




#s,s, 








P 


AS.s.o./.u.t.e, ,£x,p,r,e,s,s,/.o l n, 


i i i i 


















\m 










m 





The expression specifies the number of words to be 
reserved; the label, if specified, refers to the left- 
most word reserved. The location of the block of 
storage within the object program is determined by 
the location of the BSS statement within the source 
program . 

If the character E is punched in column 32, the 
assembler assigns the leftmost word of the reserved 
location to the next available even location. If a 
blank or any character other than E appears in 
column 32, the assembler assigns the leftmost word 
of the reserved area to the next available location 
regardless of whether that location is even or odd. 
This feature is useful when defining areas for use 
with double precision instructions . 

A BSS statement with an E format and an oper- 
and value of zero causes the Location Assignment 
Counter to be made even (if necessary) before the 
next instruction is assembled. 

A BSS instruction causes an area to be reserved, 
not cleared; therefore, it should not be assumed 
that an area reserved by a BSS instruction contains 
zeros. 

Any symbols in the operand field of a BSS assem- 
bler instruction must have been previously defined. 
The expression in the operand field must be an 
absolute expression. 

In the following example, the symbol AREA is 
equivalent to 3000; the next location assigned is 
3028. 



The BES instruction is identical to the BSS instruc- 
tion except that the address assigned to the label is 
the rightmost word in the area plus 1, i.e. , the 
next location available for assignment. 

In the previous example, the symbol AREA is 
equivalent to 3028. 



SYMBOL DEFINITION STATEMENT 

One symbol definition statement (EQU) is available in 
the IBM 1130 Assembler language. 

EQU — Equate Symbol 

The EQU statement is used to assign to a symbol a 
value other than the value of the Location Assignment 
Counter at the time the symbol is encountered. The 
format of the EQU statement is 



Label 

21 25 




Operation 

77 30 




f 

32 


T 
33 




Operands & Rei 

35 40 45 50 


S.YM&L 




E.Q.U 










Ai. ,£' l x.f,t-,e,s,s,/iO,ft> ,,.,,, 




















m 




m 






M 





The symbol in the label field is made equivalent to 
the value of the expression. The expression may be 
absolute or relocatable. All symbols appearing in 
this expression must have appeared as a label in a 
previous statement. If an asterisk (*) is used as the 
expression, the value assigned to it is the next loca- 
tion to be assigned by the assembler. 

Examples 



Label 
21 23 




Operation 

27 30 




F 
32 


T 

33 




:|5 40 43 


N,AM£> 




£.<?.</■ 










•2 A . 1 1 1 1 1 i 1 


















L.O.O.P, 




COM. 










A/tAMe.+.t, ........ 


iiii 




■ i i 










Illlllll.ll.il 
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In the first example, the symbol NAME is assigned a 
value of 26. In the second example, the symbol 
LOOP is assigned a value of 27. 
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Word 30 of the header record can be set for 
identification purposes as shown below. Word 30 is 
not used by any of the 1130 programs. 



LINKING STATEMENTS 

Linking statements are used to establish communi- 
cation between a main program and its subroutines 
or between a program and the 'Monitor system. 



ENT — Define Subroutine Entry Point 

The ENT statement should be used to define the 
entry point(s) in all subroutines except ISS and ILS. 
Up to fourteen entry points (ten with the Card/Paper 
Tape Assembler) may be defined for each subroutine 
(this would require an equal amount of ENT state- 
ments). The format of the ENT statement is shown 
below. 



Label 
21 25 




Operation 

27 30 




F 

32 


T 
33 




35 40 






E.N.T, 










N,A,M,E, , , 


















i i i 1 




i i i 










i i i i i i 



NAME is a symbol that identifies an entry point for 
the associated subroutine. This symbol must be 
relocatable. All ENT statements for a given sub- 
routine must be together and must precede all state- 
ments except LIBR, SPR, EPR, and comments 
statements. ENT, ISS, or ILS statements (see 
below) may not be used in the same subroutine. 



ISS - Define Interrupt Service Entry Point 

IBM provides interrupt service subroutines (ISS) for 
all devices; however, the user is given the option of 
replacing or adding to these subroutines with his own. 
The ISS statement is used to define an entry point in 
an interrupt service subroutine and to establish 
interrupt linkages to the subroutine during loading. 
Only one entry point may be defined for each sub- 
routine. The format of the ISS statement is shown 
below. 



Label 
21 25 




Operation 

27 30 




F 

32 


T 

33 


1 35 40 45 






I.S.S, 




N 


N 


mMAME U . . 


1 l 1 l 




1 1 1 








'<M i i i i i i i i i i i i i 



Label 

blank 

1130 

1800 



ISS Header Word 30 

blank 

1 

2 



NAME is as described for the ENT statement and 
NN (the ISS number) is a decimal number from 01 to 
20 used during loading to establish the linkage from 
the appropriate point in the corresponding ILS. The 
numbers and associated devices used in the sub- 
routines provided by IBM are listed below. 

Card/Paper Tape System and DM1 System 



Number* 

01 
02 
03 

05 
06 

07 
08 



Device or Function 

1442 Card Read Punch 

Input Keyboard/ Console Printer 

1134 Paper Tape Reader; 

1055 Paper Tape Punch 

Single Disk Storage 

1132 Printer 

1627 Plotter 

Synchronous Communications Adaptor 



*Numbers 09 through 20 are assignable by the user. 



DM2 System 



Numbe r* 



01 



Device or Function 



1442 Card Read Punch; 
1442 Card Punch 

02 Input Keyboard/ Console Printer 

03 1134 Paper Tape Reader; 
1055 Paper Tape Punch 

04 2501 Card Reader 

05 Single Disk Storage; 
2310 Disk Storage 

06 1132 Printer 

07 1627 Plotter 

08 Synchronous Communications 
Adaptor 

09 1403 Printer 

10 1231 Optical Mark Page Reader 

11 2250 Display Unit, Model 4 

* Numbers 12 through 20 are assignable by the user. 

NOTE: User-assigned ISS numbers should start at 
twenty and proceed backwards in order to avoid con- 
flict with IBM-assigned ISS numbers. 
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L is a one -digit number required by the Card/Paper 
Tape Assembler to indicate the interrupt level(s) 
associated with the subroutine. The level numbers 
(0-5) can be listed in any order in columns 45, 50, 
55, 60, 65, and 70 with the first appearing in 45, 
the second in 50, etc. 

L is not used with the monitor system. Instead, 
LEVEL control cards are used with the subroutine 
being assembled, one card per interrupt level re- 
quired (see the monitor system operator's manual). 

An ISS statement must precede all statements 
except LIBR, SPR, EPR and comments statements. 

Procedures for writing ISSs are provided in the 
subroutine library manual for the Card/Paper Tape 
and DM2 systems and in the operator's manual for 
the DM2 system. 



ILS - Define Interrupt Level Subroutine 

IBM provides interrupt level subroutines for the 
various I/O devices and their associated interrupt 
levels; however, the user may replace or add to 
these subroutines with his own. The ILS statement 
is used to define an interrupt level subroutine and to 
associate the subroutine with a specific interrupt 
level. The format of the ILS statement is shown 
below. 



Interrupt Level 



Device(s) 



Label 

21 25 




Operation 

27 30 


■'■'■ 


F 

32 


T 

33 




35 






l.l.S, 




hi 


N 




1 1 


1 1 1 1 














1 I 



NN is the interrupt level number (00-05) associated 
with the interrupt level subroutine and is used during 
loading. The devices associated with each interrupt 
level are shown below: 



Interrupt Level 


Device(s) 


00 


1442 Card Read Punch 




(1442 Card Punch) 


01 


1132 Printer, Synchronous 




Communications Adaptor 


02 


Single Disk Storage (2310 




Disk Storage) 



03 


1627 Plotter 


04 


Keyboard/Console Printer, 




1442 Card Read Punch, 




1134 Paper Tape Reader, 




1055 Paper Tape Punch 




(2501 Card Reader, 




1403 Printer, 1231 Optical 




Mark Page Reader) 


05 


PROGRAM STOP Key or 




Interrupt Run Mode. 



NOTES: 1. The devices listed in parentheses are 
used with the DM2 system only. 
2. An ILS statement must precede all statements 
except SPR, EPR, and comments statements. 
Procedures for writing interrupt level sub- 
routines are provided in the subroutine library 
manual for the Card/Paper Tape and DM1 systems 
and in the operator's manual for the DM2 system. 



CALL or LIBF Subroutines 

The user may reasonably ask when to write a LIBF 
subroutine and when a CALL subroutine. Two factors 
influence the decision. First, the maximum limita- 
tion on the size of the LIBF Transfer Vector limits 
the number of unique LIBF subroutine entry points 
referenced by any core load. There is no such limi- 
tation on the CALL subroutine. However, the CALL 
subroutine references may require more core stor- 
age. The number of words of core required by 
CALL or LIBF references varies with the type of 
call as follows: 



LIBF linkage - 
(number of references to a LIBF name) + 3 

CALL linkage = 

/(number of references to a CALL name * 3) (Monitor) 
"Vnumber of references to a CALL name * 2) (Card/Paper 

Tape System) 



Thus, in the Monitor System any subroutine entry 
name referenced four or more times in a given core 
load will be more economically written as a LIBF 
subroutine. 
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CALL - Call Direct Reference Subroutine 

A CALL statement is used to call any of the sub- 
routines in the IBM Subroutine Library that are 
written not to utilize the LIBF Transfer Vector, 
whether user- or IBM -supplied. The format of the 
CALL statement is: 



Label 
31 25 




Operation 

2? 30 




F 

32 


T 

3J 




35 40 


LAB E L 




CALL 










N.AME, , , 




:§:•:;; 














i i i 1 




j i i 










i i i i i i 



The name of the called subroutine is assembled into 
the object program, together with a unique code 
identifying the CALL. This name occupies two 
words. 

As a Monitor core load is being built, the first word 
of the called subroutine name is replaced with an 
indirect BSI instruction and the second word with 
the address of the one -word entry for that subrou- 
tine entry point in the CALL Transfer Vector, which 
will contain the address of the subroutine entry point. 

As a Card/Paper Tape System core load is being 
built, the first word of the called subroutine name 
is replaced with a long BSI instruction and the 
second word of the called subroutine name with 
the address of the subroutine entry point. Thus, 
a Transfer Vector is unnecessary in this case. 



LIBF - Call TV (Transfer Vector) Reference 
Subroutine 

A LIBF statement is used to call any of the subrou r 
tines in the IBM Subroutine Library that are written 
to utilize the LIBF Transfer Vector, whether user- 
or IBM -supplied. The format of the LIBF state- 
ment is: 



Label 

?1 25 




Operation 

27 30 




F 

32 


T 
33 




35 40 


LABEL 

i i i i 




L,l B,F 










N.A.M.E, , , 


i i i i 
















i i i i 




i i i 








l 


i i i i i i 



The name of the called subroutine is assembled 
into the object program, together with a unique 
code identifying the call as a LIBF call. This is 
replaced during loading as follows: 



Operation 



si f 



B.S.I. 



m. 



D.I.S.P.L.A.C.e.M.e.Af.T. 



I I ' ' 
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As indicated, Index Register 3 is required for the 
Transfer Vector and may be used by the user's 
program only if the following requirements are met: 

• Index Register 3 must be saved and restored 
before the execution of the next LIBF statement. 

• There must be no overlapping of I/O. 

• There must be no possibility of interrupts 
from the SCA. 



LIBF Subroutine Transfer Vector 

To fully understand the use of the LIBF statement, 
the user should be familiar with the makeup of the 
Transfer Vector, which allows mainlines to commu- 
nicate with relocatable subroutines (and relocatable 
subroutines to communicate with each other) with- 
out knowing where in core storage the subroutines 
are loaded. The Transfer Vector consists of three 
words for each entry point referred to by a LIBF 
statement. 

To build the Transfer Vector the Monitor constructs 
a Load Table of four words for each unique sub- 
routine entry point referred to by a LIBF statement. 
The name of the subroutine entry point is stored in 
the first two words. The last two words of the 
entry are initially zero. 



word 1 



word 2 



word 3 



word 4 



I 

Name of Subroutine 
I 


zero 


zero 



As shown above, Index Register 3 will be used 
during execution to point to the first word of the 
LIBF Transfer Vector entry. The displacement 
of the indexed BSI instruction replacing the LIBF 
statement in the object code is the displacement 
from the middle of a maximum size Transfer Vec- 
tor (255 words) to the first word of the referenced 
Transfer Vector entry. 

After the mainline has been processed, each sub- 
routine named in the Load Table is processed, and 
the address of the entry point is stored in the third 
word of the Load Table entry. The fourth word qf 
the entry is used for several purposes during pro- 
cessing. 
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word 1 



word 2 



word 3 



word 4 



I 

Name of Subroutine 
I 


Entry address 
of Subroutine 


undefined 



Any subroutines referenced by LIBF statements 
as the subroutines are being loaded are added to 
the Load Table (if they are not already there) and 
processed in the same manner. After the core 
load has been built, the Transfer Vector is created. 
The first word of each entry is set to zero, a long 
BSC instruction is placed in the second word, and 
the subroutine entry point address (from the corres - 
ponding Load Table entry) is stored in the third word. 



word 1 



word 2 



word 3 



zero 


BSC L 


Entry address 
of Subroutine 



In the Card/Paper Tape System, the Load Table, 
which consists of three-word entries, becomes the 
Transfer Vector. As the LIBF statements are en- 
countered during loading, the subroutine entry point 
name is stored to the first two words of the Transfer 
Vector entry. The third word of the Transfer Vector 
entry is initially zero. 



word 1 



word 2 



word 3 



Name of Subroutine 



The displacement of the indexed BSI instruction re- 
placing the LIBF statement in the object code is the 
displacement from the middle of a maximum size 
Transfer Vector to the first word of the Transfer 
Vector entry. 

As the subroutines are loaded, the third word of 
each Transfer Vector entry is replaced with the 
address of the subroutine entry point. The first 
word is cleared to zero, and a long BSC instruction 
is stored in the second word. 



word 1 



word 2 



word 3 



zero 


BSC L 


Entry address 
of Subroutine 



LIBF Subroutine Execution 



As the mainline is executed, the subroutine calls are 
encountered one by one. Each LIBF statement is 
now in the form of a BSI instruction. The BSI in- 
struction stores the contents of the IAR into the 
first word of the Transfer Vector entry associated 
with the subroutine being called and then branches to 
the second word of the same Transfer Vector entry. 
As a result, the first word of the Transfer Vector 
entry contains the address of LIBF + 1. 



word 1 



word 2 



word 3 



LIBF +1 
Address 


BSC L 


Entry Address 
of Subroutine 



Following execution of the BSI instruction, the BSC 
instruction in word 2 of the Transfer Vector entry 
is executed, transferring control to the subroutine. 
In order to access parameters and to return from a 
subroutine to the calling program, the subroutine 
must know the address of the Transfer Vector entry 
associated with the subroutine. This address was 
placed into the subroutine entry point + 2 as the 
core load was built. With this information the 
return address and the parameters associated with 
the LIBF statement may be determined by the sub- 
routine itself. See Figure 5. 

Size and Location of the Transfer Vector 

The maximum size of the Monitor Transfer Vector 
is 85 three -word entries, including an entry for the 
Floating Accumulator (FAC) and the function indica- 
tors. 



H 



Low 
Core 



FAC 

and 

Indr 



High 
Core 



LIBF TV 



CALL TV 



COMMON 



The Card/Paper Tape System Transfer Vector 
consists of a maximum of 256 words. 



H- 



Low 
Core 



FAC 

and 

Indr 



High 
Core 



LIBF TV 



COMMON 



• 25.1 
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Figure 5. Sample LIBF Coding Sequence 



Label 

21 25 




Operation 

27 30 




F 

32 


I 

33 




Operands & Remarks 

35 40 45 50 55 60 65 70 






1 1 I 1 




LX.BF 










S.U.BR . 










M.A.I.M, :P,*jO,Gr,"RA,M, ,<LA,L,L 










DC, , 


: i$ 








AiR.fr, , , 










A,D,D,R,E^,S, ©,F, ,A,R£,0,M.E>i,T, 










• i i i 










■ i i i i 




















• , i i 


























1 1 1 1 




• i i i 































E,M,D, 










S.TAR.T, 










E,Klt>, ,O.F. MAX hi. ^fcAO.'RAty 








, , , 










■ i i i i 


















































kX,B,R- 










■ i i i i 




















E.HT, 










S.UB.R. , 










S.U,BR,0,U,TX,M,E, .HEAD.EiH STA.T.ENlErt.T 






S,U,B,JL 




SXX, 






2, 




3,A,v/,£-h\ 










S.A.V.t X.N,D,EX, ,R J EG-,I,S,T,Efc ,£.,,,,. 










kDX. 




I 


£ 




*.-,#, , , 










T.rtXS, ,LiOC,AT,LO,h4, *)XL,L ,B,E. BLAM.K 






*. ■ . . 
























\dH,E,M, AilRB. T.S. ASS.EHBLE.J),,, , . . 






*, , , , 
























B.U.T, kJ,X.LL, B,E. ,FX,LLE,D, .V^XT.H, XV. 






*, . , . 














■ i i i i 










E.I4TRY, .A,D,D,R J E I S,S, ,B,y. ,T,H,E .LOA,D,E,K 










U>, , 




J- 


£ 















F.ET.CW ARG.UM.ErtT, XNTC. A.CC, , , . 
























\ 




























> 




MAXsIl ,Bo,DY, .O.F, iS.U.B.KO.UTl.^E, , , . 




















i i i i i 




, 














MDX, 






£ 




■hi. i , , 








XiKCKEWEAT, Xtf.D.EX .TLEfrXrSfTER, ,& 










STX, 






ft 




LEAVE,-!- 


I 






*,FOR, A.H.D. S,TiOR,£ fc,ET,UR,tf, AD.fi.ll 






SAVE 




U,D,X, 




u 


2 












.RjES.T.O.R.E XNDiEX R.E i 6X.S i T,&Rl & , . 






LEAVE 




B,S,C 




J. 






Tr\~ *i l 








R.ET.UR.Nl, ,TO, ,M,AXN TP.fcjO.fr.fcAN) , , , , 










exd, 










1 i 1 1 1 








1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 




















1 i l 1 l 








1 1 1 1 1 > 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 






— 1 L_L. J 




: i i i 










1 i l l l 








1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 
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MONITOR ASSEMBLER STATEMENTS 



In addition to the basic assembler statements, the 
IBM 1130 Monitor Assembler is provided with the 
following capabilities. 

Disk Data Organization 

DSA - Define Sector Address 
FILE - Define Disk File (DM2 only) 

Data Definition 

DMES - Define Message (DM2 only) 
DN - Define Name (DM2 only) 



Linking 
LINK 
EXIT 

DUMP - 

PDMP - 

List Control 

HDNG - 

LIST - 

SPAC - 

EJCT - 



Load and Execute Another Program 
Return Control to Supervisor 
Dump and Terminate (DM2 only) 
Dump and Continue (DM2 only) 



Print Heading on Each Page 

List Segments of Programs (DM2 only) 

Space Listing (DM2 only) 

Start New Page (DM2 only) 



The label is defined as the current value of the Loca- 
tion Assignment Counter when the DSA statement is 
encountered. The symbol in the operand field must 
be the name of a data file or DCI program that is on 
disk both when the assembly is made and during 
execution. 

The following statements illustrate the use of 
the DSA statement to read one sector of data. For 
a description of the disk calling sequences, see the 
system subroutines library manual. 



Label 

21 25 




Operation 

27 30 


i 
iff 


F 


T 

33 




Operands & Ren 

35 40 45 50 






il 


• 1 , 1 






















Wi 


• , , 










"•■§ 














B 


L,I,B 


F 










DJ,S,K,1, , 












M 


D.C 












/J, 0,0,0 ■ 






i i i i i i i 






tii 


o.c, 












IxOAR, , , 














D£, 




ss 








£ t R,R,0,R, , 














4 , , 










M 










J,0,A,R 




1- 


D,S,A 












D.A.TA, , . 














3,S t 3 












3J,9, , , . 














* > i 


























• , , 












■ i i i i i 












:•:•:■: 












W 


■ i i i i i 












Ws 






m 






is-a 











DISK DATA ORGANIZATION STATEMENTS 



The Assembler reserves three words in the object 
program for each DSA statement. These words are 
filled in by the Core Load Builder. For a data file 
they will contain: 



DSA - Define Sector Address 

The DSA statement allows the programmer to refer 
symbolically to a disk-stored data file or program 
stored in Disk Core Image format (DCI) without 
knowing the specific disk location of the data or 
program. The disk location of data files and pro- 
grams can vary on disk because of deletions, but the 
DSA statement allows easy reference through the 
use of the symbolic name of the data file or program. 
The format of the DSA statement is: 



LAB.B.L 



Operatic 



O.S.A, 



Operandi & R«i 



NAME, 



_! i I I -I l_ 



_l I 1 I I — L- 



_J l__J_ J l—J — I — L. 



Word 1 — Length (in words) 

Word 2 — Sector Address, including the drive code 

Word 3 — Sector count of the file 

For a program they will contain: v 

Word 1 — Length (in words) 

Word 2 — Sector Address, including the drive code 

Word 3 — Execution Address of the Program 

If the area corresponding to the DSA statement 
is used as the I/O area for a disk read operation, 
the execution address of the program must be saved 
prior to the disk call to bring in the program. (The 
contents of the third word are destroyed by the 
incoming data) . 
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The following statements illustrate the use of 
the DSA statement to supply the disk address of a 
one-sector program. 



Label 


Operation 


111 


T 

3: 




Operands & Rer 




:;: '?! # 


II 


























1 ., . , 


|1 






1 i i i l 
































±A , 








I,0A,R,+,2 
































\^s,r,o, 


1 






B,R,N,C,H,+ 


/ 




























R,£,A,D, 


■M\lj,b,f 


§ 






DiI,S,Kj i 
































mo.c, , 


i 






A.J.00,0 
































io.c. , 


11 






1,0, AR , 
































■mac, , 


';•] 






E x R,R,0& 






























CALL, 


^L,I,3,f 


f| 






DJ,SX1, 
































ilA^^ 


11 






/, 0,0, 0,0, 
































W\0,C. , 








I,0,A,R, , 
































X$MD,X, 


111 






C K A,L,L, , 






























B,R,N,C,H 


ILb.s.c 


ML 






A , , . , 
































if 1 . , , , 


|| 






































Ijl . , , , 


11 






i i i i i 
































1 . , , , 


"• 






III:! 






























i,o,A,e, 


t\o,s,A, 








P.RG.RM 
































M8,S,3, 


ll 






3,1,9, , , 
































1 «, . , 


||| 








































11 





































■ ■ ■ ■ 


^-— 


-i- 






■ i i i i 














i— 

















The following statements can be added to the 
previously shown program call to call a second pro- 
gram and have it loaded to the same area as the 
first. 



Label 




Operation 






T 




Operandi & Rer 






L,D, , 










A.p.e,2, , , 




























S.T,0 












itOA.e, , , 
































L,D, 












A.n&2,+J> 
































s,r,o 












I t O,A,R,+,l, 
































L,0, 












A,D,R,2,-+,Z, 
































sr,o 












B,R,N,C,H,+,1 
































M,D,X 












R,E,A,D, , , 


























A,DM,2 






D,S,A 












P t G,R,M,Z, , 
































*, i 












































♦ i i 
























































i 







































































The execution address of the second program can be 
different from the first, but the programs must be 
executable from the same locations. This requires 
a certain amount of planning before assembling the 
"overlay" programs. 



Programming Considerations 

The following considerations must be observed by 
the user who wishes to use the DSA statement to 
supply the disk address for programs. 



• The called programs must be in DCI format. 

• If the calling program is converted to DCI format, 
the data for the DSA statement is filled in during 
the core image conversion and will be fixed for all 
subsequent executions. Thus, if the referenced 
program or data files are subsequently moved, 
incorrect results will occur. Data files refer- 
enced by a Core Image program should be stored 
in the Fixed area. 

• Any loading functions, such as the setting of Index 
Register 3, will have to be supplied by the calling 
program. 



FILE - Define Disk File (DM2) 

The FILE statement specifies to the Assembler the 
file identification, the number of file records in a 
file, and the size of each record in a disk data file 
that will be used with a particular mainline and its 
associated subprograms. The Assembler FILE 
statement allows the Assembler language user to 
defile files so that they are similar to FORTRAN 
defined files. 

As a core load is constructed by the Core Load 
Builder, the defined files are equated to data files 
already assigned in the User/Fixed Area or to files 
in Working Storage. 

The FILE statement must not appear in a sub- 
program; it- is permitted only in a relocatable main- 
line program. Therefore, all subprograms used 
by the mainline must use the defined files of the 
mainline. The format of the FILE statement is as 
follows: 



Label 

1\ 25 




Operation 

77 30 




F 
n 


T 




Operandi & Rer 

35 40 45 50 


-£,.,, 




F,I,L,£ 










Qij ,M,f ,n.,f ic/j i V\ l x i i i l i j ii 



































where 

1 is any valid label (optional), 

a is the file identification number, a decimal 
integer in the range 1-32767, 

m is a decimal integer that defines the number 
of records in the file, 

n is a decimal integer in the range 1-320 that de- 
fines the length (in words) of the longest record 
in the file, 
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U is a required constant, specifying that the file 
must be read/written with no data conversion, 

v is the associated variable, the label of a core 
location (variable) defined elsewhere in the pro- 
gram. 



FILE statements must precede all other state- 
ments except HDNG, EPR, SPR, EJCT, SPAC, and 
LIST in the source program. The label, if used, is 
assigned the location of the first word of the seven 
words generated (see list below). The Format and 
Tag fields are not used and should be left blank. 

Each FILE statement causes the Location Assign- 
ment Counter to be incremented by seven. The data 
stored in these seven words, which constitute a 
DEFINE FILE Table entry in the object program is 
as follows: 



Word Contents 

1 a, the file identification number 

2 m, the number of records per file 

3 n, the record length (in words) 

4 The address of the associated variable, v. 

5 Zero. This word is filled by the Core 

Load Builder with the sector address of the 
data file. This address is relative to the 
address of Working Storage (with bit zero 
set to one) for Working Storage files and is 
absolute, including the drive code, for User/ 
Fixed area files. 

6 r, the number of records per sector. The 

number, computed by the Assembler, is 
the quotient of 



320 



(remainder ignored) 
b, the number of disk blocks per file. 
This number, computed by the Assembler, 
is the quotient of 

16(m) 
r 



DATA DEFINITION STATEMENTS 



DMES - Define Message (DM2) 

The DMES statement is used to store a message with- 
in a program in a form that is acceptable to the 
printer output subroutines. The format of the DMES 
statement follows: 



&§ Operatio 



U I I 1_ 



DMES 



Operandi & Rer 



_i I I I I .J- 



where 

1 is any valid label (optional) , 

p is the printer type code, 

m is any string of valid message and control 
characters. 

If a label is present, it is assigned to the location 
of the first word generated. The Tag field (column 
33) is used to specify the printer type code: 

Tag Printer 

b or Console Printer 

1 1403 Printer 

2 1132 Printer 

If the Tag field (printer type code) contains a char- 
acter other than blank, zero, one, or two, an error 
results and the message is stored two EBCDIC char- 
acters per word. 

The Operand field contains the control and mess- 
age characters. Remarks are permitted only after 
an 'E or 'b control character. 

The output generated by one DMES statement can- 
not exceed 60 words (120 characters). If an odd 
number of characters is generated, the last word is 
filled in with a blank, except when the statement 
ends with 'b. In this case, the first character of the 
next DMES statement is used to fill out the word. 

Control characters are used to specify certain 
printer operations and to define message parameters. 
Each control character is actually two characters, 
the first of which is always an apostrophe. The apos- 
trophe (5-8 punch in IBM Card Code) is a control 
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delimiter and therefore is not included in the char- 
acter count. The control characters and their func- 
tions or meanings are as follows: 



Assembler input: 



Control 




Character 


Function or Meaning 


'X 


Blank (or space) 


*T 


Tabulate 


'D 


Backspace 


'B 


Print black 


'A 


Print red 


'S 


Space (or blank) 


'R 


Carriage return 


'L 


Line feed 


'F 


Repeat following character 


'E 


End of message 


T b 


(b=blank) continues text with next DMES 




statement 



Label 


i 


Operation 

„ 


%% 


F 


T 


i-i-i 


Operandi & Remarks 


_l J. J 1 




DME^S 










',R,5,A,M,P,L,E, ,P,R I 1 6,R,AM,',',S,', . 


! , 




, , 






PMF.S 










>O.U,T,P,U,T, , 


i \ 

I i 

L... 1 




( , 




8 


DMES 








H 


1 <Z,R,' ,9,Q<1,' ,9,3,2,' ,9,S,3,' ,9,S,4,' ,E> 




, , 




i§ 


DMES 










' A,l,Z,3,4S,6,7,S,9d,l,2,3,4£,(b,7,8,9 i ' 




, , 






DMES 










0^1,2,3,4,^6, 7,8,9,<f>'j,2,3,4,5 t &, 7,8,9,0. ' 




, 




•;•§ 


DMES 








:§! 


, .2./e,'>7 l X>',7,F>-. , .4,P.F>C.X.) / , 




1 




%DM,ES 


H 








/ ,7,X,',S,f.-,',S,0,F l ',',r,X,) .',£. 




1 1 




! 


...!._, ■ ^ 


i~ 






4i 


1 1 1 i 1 1 1 1 1 1 i ] 1 1 1 I 1 1 1 1 1 



Printed output: 



SAMPLE PROGRAM'S OUTPUT 



12 3 4 

12 34 56 789012 34 56 78901234 567 8901234567890 



F(X) 



F' (X) 



All the above characters can be used when the printer 
is the Console Printer. Only 'E, r F, 'S, ? X and 'b 
are valid control characters when the 1132 or 1403 
Printer is specified; any other control characters 
are considered as errors. 

The characters 'X and 'S are interchangeable. A 
blank character is generated for either 'X or 'S if the 
1132 or 1403 Printer is specified; a space is gener- 
ated for either 'X or 'S if the Console Printer is 
specified. 

The character 'F (repeat following character) 
refers only to message characters. The control 
characters themselves, except 'A, 'B, 'E, and 'b, 
can be repeated up to 99 times by inserting a number 
(1-99) between the apostrophe and unique control 
definition character. For example, '32S results in 
32 space characters being inserted in the generated 
message. 

The character 'E is used to designate the end of 
the message line. The character 'b is used to desig- 
nate that the message is continued on the following 
DMES statement. If neither 'E nor 'b is included, 'E 
is assumed to follow column 71. DMES statements 
that end with 'b must be followed by another DMES 
statement. 

Text apostrophes are generated by writing two 
successive apostrophes. 

The message characters can be any valid charac- 
ter for the printer being used. Invalid characters 
are replaced with blanks. 

The following example illustrates the DMES 
statement. 



Note that the device code specified in the preceding 
example is blank in order to generate a message for 
the Console Printer. 



DN — Define Name 

The Define Name statement is used to convert a 
name specified in the Operand field of the state- 
ment to a name in Name Code in the object pro- 
gram. The format of this statement is shown 
below: 



Label 






OperaMon 




F 


T 








Operands & Rer 


21 


25 


■W: 


27 30 




32 


33 


;S: 


35 


10 45 


50 


£ 


■:•:•:; 


DM , 


§8 








fit , , , , 






























Ha 




m 















where 

I is any valid label (optional), 
n is any valid label or name. 

Name Code is truncated packed EBCDIC. The two 
high order bits of each character in the name are 
removed and the five characters are packed into the 
right thirty bits of two words. 

00 c h a 1 r s 

xx |xx xxxx|xxxx xx|xx xxjxxjxxxx XX|XX xxxx| 
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If a label is used, the address assigned to it is the 
location of the first word of the two words generated 
and is equal to the current value of the Location 
Assignment Counter. Columns 32 and 33 must be 
blank. The operand can have up to five characters 
that comply with the rules for writing symbols. The 
name to be converted must be left- justified in the 
Operand field. If remarks are used, one blank must 
be left between the operand and the remarks. The 
Location Assignment Counter is incremented by two 
for this statement. 



LINKING STATEMENTS 



LINK — Load Link Program 

In the assembler language, the LINK statement is 
used to cause another core load to be loaded and 
executed. Only COMMON of the current core load 
is saved. The program loaded and executed must 
be specified by name. The format of the LINK 
statement is: 

1. A symbol or blanks in the label field 

2. The mnemonic, LINK, in columns 27-30 

3. A valid program name in the operand field 

The label of the LINK pseudo-operation is de- 
fined as the current value of the Location Assignment 
Counter when the LINK statement is encountered; 
this value is the address of the first word generated 
by the LINK statement. 

The operand field contains a valid program name 
(one to five alphameric characters) , left -justified in 
the field. The name" must be present in LET/FLET 
at execution time. The LINK statement causes four 
words to be generated in the object program. The 
first two words contain a long BSI instruction, which 
branches to a specified location within the Skeleton 
Supervisor. The next two words contain the program 
name in Name Code (see DN - Define Name). The 
Core Image Loader uses the core load name and be- 
gins the process required to load the new core load. 



EXIT — Return to Supervisor 

In the assembler language, the EXIT statement is 
used to return control to the Supervisor. The format 
of the EXIT statement is: 



1. A symbol or blanks in the label field 

2. The mnemonic, EXIT, in columns 27-30 

The label of the EXIT statement is defined as 
the current value of the Location Assignment Counter 
when the EXIT statement is encountered; this value 
is the address of the instruction generated by an 
EXIT statement. The operand field is ignored and 
can therefore be used for remarks. 

The EXIT statement causes a short branch in- 
struction to be generated in the object program. 
The instruction branches to a fixed location in the 
Skeleton Supervisor. During execution, the branch 
is executed and control is returned to the Supervisor. 
The EXIT statement should be the last logical state- 
ment in a program. 



DUMP — Dump and Terminate Execution 

The DUMP statement provides an entry to the System 
DUMP program, which prints the contents of core 
storage on the principal print device in hexadecimal 
format. 

The DUMP statement allows for flexible specifica- 
tion of the upper and lower limits to be dumped with- 
out altering core storage. After core has been 
dumped between the limits specified, the System 
Dump returns control to the calling program, at 
which point a CALL EXIT is executed. The DUMP 
statement is written as follows: 



Label 

21 25 




Operation 

77 30 




F 

32 


T 




Operands & Ren 

35 40 45 50 


X, , , , 




D.UMP 










AifiAiirl i i i i i I i i i i I i i i 




: : >$ 










*£ 






'$. 










m 





where 

1 is any valid label (optional) , 

a is any valid expression specifying the lowest- 
addressed core location to be dumped, 

b is any valid expression specifying the highest- 
addressed core location to be dumped, 

f is the dump format code (either blank or zero). 
The dump is always in hexadecimal format. 

The label, if used, is assigned the location of the 
first of the six words generated (see list below). 
The Tag and Format fields must be left blank. 
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A DUMP statement causes the Location Assign- 
ment Counter to be incremented by six. The data 
stored in these six words is as follows: 



Word 



1} 



Contents 

A long (two -word) BSI to the DUMP entry- 
point in the Skeleton Supervisor 

The format indicator (always zero) 
The starting address of the core dump 
The ending location of the core dump 
A short branch to the EXIT entry point 
in the Skeleton Supervisor 



If no address is specified for word 3, the dump 
starts in location zero. If no address is specified 
for word 4, the dump continues to the end of core. 

A DUMP statement can be used at any point in a 
program; however, the user is reminded that DUMP 
causes a terminal DUMP to be printed. At the com- 
pletion of the dump printout, the branch to EXIT is 
executed, thus transferring control to the Skeleton 
Supervisor for processing of the next job or subjob. 

The format of the DUMP program output is as 
follows: 

AAAA xxxx xxxx xxxx u xxxx xxxx xxxx 

The contents (xxxx) of 16 core storage locations are 
printed per line. At the left is the address (AAAA) 
of the first location printed on that line. 



LIST CONTROL STATEMENTS 

The list control statements — HDNG, LIST, SPAC, 
and EJCT — provide the user with the means to 
control and identify the assembler output listing. 



HDNG — Heading 

The HDNG statement is used to specify a one line 
page heading for a printed listing. The heading 
line consists of the data in the Operand-Remarks 
field. 

The format of the HDNG statement is as follows. 



Label 

21 25 




Operation 

27 30 




F 

32 


T 

33 




Oi 

35 40 45 5t. 






H.DMG 










P,A.6.E ,H.£,A,D,/M6, , , . 






I 










, , , , , iii, 



















Multiple HDNG statements may be used thus 
allowing different sections of a listing to have 
different page headings. 

When the 1132 or 1403 is the principal printer, 
the HDNG statement causes the listing to be ejected 
to a new page and the heading is printed. The same 
heading is repeated at the top of each succeeding 
page until a new HDNG statement is encountered. 

When the Console Printer is the principal printer, 
the heading line is preceded by five line feeds and 
followed by a single line feed, and otherwise functions 
as a comments statement. 



PDMP — Dump and Continue Execution 

The PDMP statement provides the ability to dump 
core storage between specified limits and to continue 
execution. The core dump is printed on the principal 
print device without altering core. The PDMP state- 
ment is specified in the same way as DUMP, except 
that PDMP appears in columns 27-30 instead of 
DUMP. 

The PDMP statement is translated by the Assem- 
bler into a long BSI to the DUMP entry point in the 
Skeleton Supervisor. The parameters (operands) are 
converted as described in the DUMP statement (see 
above) except that the exit to the Supervisor is not 
generated for PDMP. 

Upon completion of the printout of the core dump, 
control is returned to the next instruction following 
the PDMP statement to continue execution. 



LIST — List Segments of Program 

The LIST statement allows the user to list certain 
segments of a program on the principal printer and 
avoid listing other segments. The three variations 
of the LIST statement are shown below: 



Label 

21 25 




Operation 

27 30 


rrr 


F 

32 


T 

33 




Operandi & Rer 

35 40 45 W 






L.I.S.T 










l__L_ J L -1 L -J l_. _L. 1 1 1 L J J_ J 1 1 L_ 






LJ.S.T 










0\N\ _1 1 i _l _L L 1 1. 1 1 1 1 1 1 1 1 - 1 . 






L,I,S,T 










OtF,/~i i i i i i.l.i i i i i i i i.i. L 
















L. 1 X _1. .1 A 1 1 1 1 1 1 I.I 1 1 1 I.I. 




m 















The Label, Tag, and Format fields are not used 
with the LIST statement and should be left blank. The 
Operand field may be left blank or may contain the 
operand ON or OFF. 
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The LIST statement does not cause the Location 
Assignment Counter to be incremented. 

If a LIST statement with the operand ON is en- 
countered, the following statements, up to the next 
LIST statement, are listed by the Assembler. 

If a LIST statement with no operand is encountered, 
the Assembler assumes an operand depending on the 
use of the LIST control record. If the LIST control 
record preceded the assembly, the ON operand is 
assumed and the Assembler acts accordingly. If 
the LIST control record did not precede the assembly, 
the OFF operand is assumed and the Assembler acts 
accordingly. 



operand can be any valid expression. The operand 
(expression) value must be positive; otherwise, the 
Assembler ignores the statement. 

When the number of blank lines specified exceeds 
the number of lines left on the page, the page is 
spaced to the bottom, a restore occurs, a new 
heading is printed, and spacing is resumed until the 
number of blank lines specified has been exhausted. 

The SPAC statement does not cause the Location 
Assignment Counter to be incremented. 



EJCT — Start New Page 



SPAC — Space Listing 

The SPAC statement is used to insert one or more 
blank lines in the listing immediately following the 
SPAC statement. The format of the SPAC state- 
ment is as follows: 



Label 

21 25 


m 


Operation 

27 30 




F 

32 


T 

33 


W- 


Operandi & Rei 

33 40 43 50 




'M 


S.P.A.C 


$i 










i 1 I 1 


\ti+ 


1 1 1 


&i 






tS 


i ■ i i " i " i i i i i i i 



where e is any valid positive expression. 

The Label, Format, and Tag fields are not used 
and should be left blank* 

The number of blank lines inserted in the listing 
is determined by the operand in the statement. The 



The EJCT statement causes the next line of the list- 
ing to appear at the top of a new page following the 
page heading. The format of the EJCT statement is 
as follows: 



\ £j,cr 



Operandi & Rei 



_1_.J I L _J I l- 



_l l I I I I I I I I— .1 L. 



The Label, Tag, Format, and Operand fields are not 
used and should be left blank. 

A page overflow occurs immediately following the 
EJCT statement. EJCT statements may be used in 
succession to obtain blank pages (except for the 
headings printed). 

The EJCT statement does not cause the Location 
Assignment Counter to be incremented. 
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APPENDIX A. CHARACTER CODE SUMMARY 



Hexadecimal Notation 

In hexadecimal notation, each digit represents a 
four -bit binary value. This means that a 16 -bit 
word in the Processor-Controller can be expressed 
as four hexadecimal digits. The binary — hexa- 
decimal — decimal correspondence is defined as 
follows : 



Binary 


Hexadecimal 


Decimal 


0000 








0001 


1 


1 


0010 


2 


2 


0011 


3 


3 


0100 


4 


4 


0101 


5 


5 


0110 


6 


6 


0111 


7 


7 


1000 


8 


8 


1001 


9 


9 


1010 


A 


10 


1011 


B 


11 


1100 


C 


12 


1101 


D 


13 


1110 


E 


14 


1111 


F 


15 



the table that follows, each EBCDIC character is 
expressed as two hexadecimal digits. 

IBM Card Code 

In the IBM Card Code, each character represents a 
12-bit card-column image. In the table that follows, 
each card code character is expressed as four hexa- 
decimal digits and as the card-column image. 

Paper Tape Transmission Code, 8 Channel (PTTC/8) 

In the PTTC/8 code, each character is represented 
by a unique configuration of a case shift, plus an 
eight-bit code . The case shift can be common to 
more than one character and need be inserted only 
when a case shift change is necessary. In the table 
that follows, each character is expressed as two 
hexadecimal digits, followed by the case shift in 
parentheses. 

1132 Printer EBCDIC Subset Hex Code 

In the 1132 Printer EBCDIC subset hex code, each 
character is represented by a unique configuration of 
eight bits. In the table that follows, each 1132 
Printer character is expressed as two hexadecimal 
digits. 

Console Printer Hex Code 



Extended Binary Coded Decimal Interchange Code 
(EBCDIC) 

In the EBCDIC code, each character is represented 
by a unique configuration of eight binary bits. In 



In the Console Printer hexadecimal code each charac- 
ter is represented as two hexadecimal digits. 

1403 Printer Hex Code 

In the 1403 Printer hexadecimal code each character 
is represented as two hexadecimal digits. 
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Ref 
No. 


EBCDIC 


IBM Card Code 


Graph 


ics and Control 
Nantes 


1132 
Printer 
EBCDIC 


PTTC/8 
Hex 

U -Upper Case 


Console 

Printer 

Hex 

Notes 


1403 
Printer 


Binary 


Hex 






Rows 




Hex 




0123 4567 




12 


11 


9 8 


7-1 








Subset Hex 


L-Lower Case 


Hex 


0000 0000 


00 


12 




9 8 


1 


B030 


NUL 












1 


0001 


01 


12 




9 


1 


9010 














2 


0010 


02 


12 




9 


2 


8810 














3 


0011 


03 


12 




9 


3 


8410 














4 


0100 


04 


12 




9 


4 


8210 


PF 


Punch Off 










5* 


0101 


05 


12 




9 


5 


8110 


HT 


Horiz.Tab 




6 D (U/L) 


41 © 




6* 


0110 


06 


12 




9 


6 


8090 


LC 


Lower Case 




6E (U/L) 




7* 


0111 


07 


12 




9 


7 


8050 


DEL 


Delete 




7F (U/L) 






8 


1000 


08 


12 




9 8 




8030 














9 


1001 


09 


12 




9 8 


1 


9030 














10 


1010 


OA 


12 




9 8 


2 


8830 














11 


1011 


OB 


12 




9 8 


3 


8430 














12 


1100 


oc 


12 




9 8 


4 


8230 














13 


1101 


OD 


12 




9 8 


5 


8130 














14 


1110 


OE 


12 




9 8 


6 


80B0 














15 


1 mi 


OF 


12 




9 8 


7 


8070 














16 0001 0000 


10 


12 


11 


9 8 


1 


D030 














17 


0001 


11 




11 


9 


1 


5010 














18 


0010 


12 




n 


9 


2 


4810 














19 


0011 


13 




n 


9 


3 


4410 














20* 


0100 


14 




n 


9 


4 


4210 


RES 


Restore 




4C (U/L) 


05 © 




21* 


0101 


15 




n 


9 


5 


4110 


NL 


New Line 




DD(U/L) 


81 (3) 




22* 


0110 


16 




n 


9 


6 


4090 


BS 


Backspace 




5E (U/L) 


n 




23 


0111 


17 




n 


9 


7 


4050 


IDL 


Idle 










24 


1000 


18 




n 


9 8 




4030 














25 


1001 


19 




n 


9 8 


1 


5030 














26 


1010 


1A 




n 


9 8 


2 


4830 














27 


1011 


IB 




n 


9 8 


3 


4430 














28 


1100 


1C 




n 


9 8 


4 


4230 














29 


1101 


ID 




n 


9 8 


5 


4130 














30 


1110 


IE 




n 


9 8 


6 


40B0 














31 \ 


1 mi 


IF 




n 


9 8 


7 


4070 














32 0010 0000 


20 




n 


9 8 


1 


7030 














33 


0001 


21 






9 


1 


3010 














34 


0010 


22 






9 


2 


2810 














35 


0011 


23 






9 


3 


2410 














36 


0100 


24 






9 


4 


2210 


BYP 


Bypass 










37* 


0101 


25 






9 


5 


2110 


LF 


Line Feed 




3 D (U/L) 


03 




38* 


0110 


26 






9 


6 


2090 


EOB 


End of Block 




3 E (U/L) 






39 


0111 


27 






9 


7 


2050 


PRE 


Prefix 










40 


1000 


28 






9 8 




2030 














41 


1001 


29 






9 8 


1 


3030 














42 


1010 


2A 






9 8 


2 


2830 














43 


1011 


2B 






9 8 


3 


2430 














44 


1100 


2C 






9 8 


4 


2230 














45 


1101 


2D 






9 8 


5 


2130 














46 


1110 


2E 






9 8 


6 


20B0 














47 1 


nn 


2F 






9 8 


7 


2070 














48 00 1 1 0000 


30 


12 


n 


9 8 


1 


F030 














49 


0001 


31 






9 


1 


1010 














50 


0010 


32 






9 


2 


0810 














51 


0011 


33 






9 


3 


0410 














52 


0100 


34 






9 


4 


0210 


PN 


Punch On 










53* 


0101 


35 






9 


5 


0110 


RS 


Reader Stop 




0D(U/L) 


09 © 




54* 


0110 


36 






9 


6 


0090 


UC 


Upper Case 




0E(UA) 






55 


0111 


37 






9 


7 


0050 


EOT 


End of Trans. 










56 


1000 


38 






9 8 




0030 














57 


1001 


39 






9 8 


1 


1030 














58 


1010 


3A 






9 8 


2 


0830 














59 


1011 


3B 






9 8 


3 


0430 














60 


1100 


3C 






9 8 


4 


0230 














61 


1101 


3D 






9 8 


5 


0130 














62 


1110 


3E 






9 8 


6 


00B0 














63 \ 


nn 


3F 






9 8 


7 


0070 






1 







NOTES: Typewriter Output 
© Tabulate 
(2) Shift to black 



Carrier Return * Recognized by all Conversion subroutines 

Shift to red Codes that are not asterisked are recognized only by the SPEED subroutine 
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Ref 


EBCDIC 


IBM Card Code 


Grgphics and Control 


1132 
Printer 


PTTC/8 
Hex 


Console 
Printer 


1403 
Printer 


Binary 


Hex 




Rows 




Hex 


No. 














Names 


EBCDIC 


U -Upper Case 




Hex 




0123 4567 




12 


10 9 8 


7-1 






Subset Hex 


L-Lower Case 


Hex 


64* 0100 0000 


40 




no punches 




0000 


blank 


40 


10 (U/L) 


21 


7F 


65 


0001 


41 


12 


9 


1 


B010 












66 


0010 


42 


12 


9 


2 


A810 












67 


0011 


43 


12 


9 


3 


A410 












68 


0100 


44 


12 


9 


4 


A210 












69 


0101 


45 


12 


9 


5 


A110 












70 


0110 


46 


12 


9 


6 


A090 












71 


0111 


47 


12 


9 


7 


A050 












72 


1000 


48 


12 


9 8 




A030 












73 


1001 


49 


12 


8 


1 


9020 












74* 


1010 


4A 


12 


8 


2 


8820 


* 




20 (U) 


02 




75* 


1011 


4B 


12 


8 


3 


8420 


(period) 


4B 


6B(L) 


00 


6E 


76* 


1100 


4C 


12 


8 


4 


8220 


< 




02 (U) 


DE 




77* 


1101 


4D 


12 


8 


5 


8120 


( 


4D 


19 (U) 


FE 


57 


78* 


1110 


4E 


12 


8 


6 


80A0 


+ 


4E 


70 (U) 


DA 


6D 


79* 1 


' 1111 


4f 


12 


8 


7 


8060 


1 (logical OR) 




3B(U) 


C6 




80* 0101 0000 


50 


12 






8000 


& 


50 


70 (L) 


44 


15 


81 


0001 


51 


12 1 


1 9 


1 


D010 












82 


0010 


52 


12 1 


1 9 


2 


C810 












83 


0011 


53 


12 1 


1 9 


3 


C410 












84 


0100 


54 


12 1 


1 9 


4 


C210 












85 


0101 


55 


12 1 


1 9 


5 


C110 












86 


0110 


56 


12 1 


1 9 


6 


C090 












87 


0111 


57 


12 1 


1 9 


7 


C050 












88 


1000 


58 


12 1 


1 9 8 




C030 












89 


1001 


59 




1 8 


1 


5020 












90* 


1010 


5A 




1 8 


2 


4820 


1 




5B(U) 


42 




91* 


1011 


5B 




1 8 


3 


4420 


$ 


5B 


5B(L) 


40 


62 


92* 


1100 


5C 




1 8 


4 


4220 


* 


5C 


08(U) 


D6 


23 


93* 


1101 


5D 




1 8 


5 


4120 


) 


5D 


1A(U) 


F6 


2F 


94* 


1110 


5E 




1 8 


6 


40A0 






13 (U) 


D2 




95* 1 


mi 


5F 




1 8 


7 


4060 


-^T (logical NOT) 




6B(U) 


F2 




96* 0110 0000 


60 








4000 


- (dash) 


60 


40 (L) 


84 


61 


97* 


0001 


61 







1 


3000 


/ 


61 


31 (L) 


BC 


4C 


98 


0010 


62 




1 9 


2 


6810 












99 


0011 


63 




1 9 


3 


6410 












100 


0100 


64 




1 9 


4 


6210 












101 


0101 


65 




1 9 


5 


6110 












102 


0110 


66 




1 9 


6 


6090 












103 


0111 


67 




1 9 


7 


6050 












104 


1000 


68 




10 9 8 




6030 












105 


1001 


69 




8 


1 


3020 












106 


1010 


6A 


12 1 


1 




COOO 












107* 


1011 


6B 




8 


3 


2420 


, (comma) 


6B 


3B(L) 


80 


16 


108* 


1100 


6C 




8 


4 


2220 


% 




15 (U) 


06 




109* 


1101 


6D 




8 


5 


2120 


(underscore) 




40 (U) 


BE 




110* 


1110 


6E 




8 


6 


20A0 


> 




07 (U) 


46 




111* ¥ 1111 


6F 




8 


7 


2060 


? 




31 (U) 


86 




112 0111 0000 


70 


12 1 


1 




E000 












113 


0001 


71 


12 1 


1 9 


1 


F010 












114 


0010 


72 


12 1 


1 9 


2 


E810 












115 


0011 


73 


12 1 


1 9 


3 


E410 












116 


0100 


74 


12 1 


1 9 


4 


E210 












117 


0101 


75 


12 1 


1 9 


5 


El 10 












118 


0110 


76 


12 1 


1 9 


6 


E090 












119 


0111 


77 


12 1 


1 9 


7 


E050 












120 


1000 


78 


12 1 


10 9 8 




E030 












121 


1001 


79 




8 


1 


1020 












122* 


1010 


7A 




8 


2 


0820 






04 (U) 


82 




123* 


1011 


7B 




8 


3 


0420 


# 




0B(L) 


CO 




124* 


1100 


7C 




8 


4 


0220 


@ 




20 (L) 


04 




125* 


1101 


7D 




8 


5 


0120 


' (apostrophe) 


7D 


16 (U) 


E6 


0B 


126* 


1110 


7E 




8 


6 


00A0 


= 


7E 


01 (U) 


C2 


4A 


127* f 1111 


7F 




8 


7 


0060 






0B(U) 


E2 
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Ref 
No. 


EBCDIC 


IBM Card Code 


Graphics and Control 
Names 


1132 
Printer 
EBCDIC 


PTTC/8 
Hex 

U -Upper Case 


Console 
Printer 


1403 

Printer 

Hex 


Binary 


Hex 




Rows 


Hex 




0123 4567 




12 


11 9 8 7-1 






Subset Hex 


L -Lower Case 


Hex 


128 1000 0000 


80 


12 


8 1 


B020 












129 


0001 


81 


12 


1 


B000 


a 










130 


0010 


82 


12 


2 


A800 


b 










131 


0011 


83 


12 


3 


A400 


c 










132 


0100 


84 


12 


4 


A200 


d 










133 


0101 


85 


12 


5 


A 100 


e 










134 


0110 


86 


12 


6 


A080 


f 










135 


0111 


87 


12 


7 


A040 


g 










136 


1000 


88 


12 


8 


A020 


h 










137 


1001 


89 


12 


9 


A010 


i 










138 


1010 


8A 


12 


8 2 


A820 












139 


1011 


8B 


12 


8 3 


A420 












140 


1100 


8C 


12 


8 4 


A220 












141 


1101 


8D 


12 


8 5 


A120 












142 


1110 


8E 


12 


8 6 


AOAO 












143 


' 1111 


8F 


12 


8 7 


A060 












144 1001 0000 


90 


12 


11 8 1 


D020 












145 


0001 


91 


12 


11 1 


DOOO 


i 










146 


0010 


92 


12 


11 2 


C800 


k 










147 


0011 


93 


12 


11 3 


C400 


1 










148 


0100 


94 


12 


11 4 


C200 


m 










149 


0101 


95 


12 


11 5 


C100 


n 










150 


0110 


96 


12 


11 6 


C080 


o 










151 


0111 


97 


12 


11 7 


C040 


P 










152 


1000 


98 


12 


11 8 


C020 


q 










153 


1001 


99 


12' 


11 9 


C010 


r 










154 


1010 


9A 


12 


11 8 2 


C820 












155 


1011 


9B 


12 


11 8 3 


C420 












156 


1100 


9C 


12 


11 8 4 


C220 












157 


1101 


9D 


12 


11 8 5 


C120 












158 


1110 


9E 


12 


11 8 6 


COAO 












159 \ 


1 mi 


9F 


12 


11 8 7 


C060 


. 










160 1010 0000 


AO 




11 8 1 


7020 












161 


0001 


Al 




11 1 


7000 












162 


0010 


A2 




110 2 


6800 


s 










163 


0011 


A3 




11 3 


6400 


t 










164 


0100 


A4 




11 4 


6200 


u 










165 


0101 


A5 




11 5 


6100 


V 










166 


0110 


A6 




110 6 


6080 


w 










167 


0111 


A7 




110 7 


6040 


x 










168 


1000 


A8 




110 8 


6020 


y 










169 


1001 


A9 




11 9 


6010 


z 










170 


1010 


AA 




11 8 2 


6820 












171 


1011 


AB 




11 8 3 


6420 












172 


1100 


AC 




11 8 4 


6220 












173 


1101 


AD 




11 8 5 


6120 












174 


1110 


AE 




11 8 6 


60A0 












1 75 » 1111 


AF 




11 8 7 


6060 












176 1011 0000 


BO 


12 


11 8 1 


F020 












177 


0001 


Bl 


12 


110 1 


FOOO 












178 


0010 


B2 


12 


110 2 


E800 












179 


0011 


B3 


12 


110 3 


E400 












180 


0100 


B4 


12 


11 4 


E200 












181 


0101 


B5 


12 


110 5 


E100 












182 


0110 


B6 


12 


11 6 


E080 












183 


0111 


B7 


12 


11 7 


E040 












184 


1000 


B8 


12 


11 8 


E020 












185 


1001 


B9 


12 


11 9 


E010 












186 


1010 


BA 


12 


11 8 2 


E820 












187 


1011 


BB 


12 


11 8 3 


E420 












188 


1100 


BC 


12 


11 8 4 


E220 












189 


1101 


BD 


12 


11 8 5 


E120 












190 


1110 


BE 


12 


11 8 6 


EOAO 












191 1 


1111 


BF 1 


12 


11 8 7 


E060 













36 



Ref 
No. 


EBCDIC 


IBM Card Code 


Graphics and Control 


1132 
Printer 


PTTC/8 
Hex 


Console 
Printer 


1403 
Printer 


Binary 


Hex 






Rows 




Hex 
















Names 


EBCDIC 


U-Upper Case 








0123 4567 




12 


11 


9 8 


7-1 






Subset Hex 


L-Lower Case 


Hex 


Hex 


192 1100 0000 


CO 


12 









A000 


(+ zero) 










193* 


0001 


CI 


12 






1 


9000 


A 


CI 


61 (U) 


3C or 3E 


64 


194* 


0010 


C2 


12 






2 


8800 


B 


C2 


62 (U) 


18 or 1A 


25 


195* 


0011 


C3 


12 






3 


8400 


C 


C3 


73 (U) 


1C or IE 


26 


196* 


0100 


C4 


12 






4 


8200 


D 


C4 


64 (U) 


30 or 32 


67 


197* 


0101 


C5 


12 






5 


8100 


E 


C5 


75 (U) 


34 or 36 


68 


198* 


0110 


C6 


12 






6 


8080 


F 


C6 


76 (U) 


10 or 12 


29 


199* 


0111 


C7 


12 






7 


8040 


G 


C7 


67 (U) 


14 or 16 


2A 


200* 


1000 


C8 


12 




8 




8020 


H 


C8 


68 (U) 


24 or 26 


6B 


201* 


1001 


C9 


12 




9 




8010 


1 


C9 


79 (U) 


20 or 22 


2C 


202 


1010 


CA 


12 




9 8 


2 


A830 












203 


1011 


CB 


12 




9 8 


3 


A430 












204 


1100 


cc 


12 




9 8 


4 


A230 












205 


1101 


CD 


12 




9 8 


5 


A130 












206 


1110 


CE 


12 




9 8 


6 


AOBO 












207 


' mi 


CF 


12 




9 8 


7 


A070 












208 1101 0000 


DO 




11 







6000 


(- zero) 










209* 


0001 


Dl 




11 




1 


5000 


J 


Dl 


51 (U) 


7C or 7 E 


58 


210* 


0010 


D2 




11 




2 


4800 


K 


D2 


52 (U) 


58 or 5A 


19 


211* 


0011 


D3 




11 




3 


4400 


L 


D3 


43 (U) 


5C or 5E 


1A 


212* 


0100 


D4 




11 




4 


4200 


M 


D4 


54 (U) 


70 or 72 


5B 


213* 


0101 


D5 




11 




5 


4100 


N 


D5 


45 (U) 


74 or 76 


1C 


214* 


0110 


D6 




11 




6 


4080 


O 


D6 


46 (U) 


™ or 52 


5D 


215* 


0111 


D7 




11 




7 


4040 


P 


D7 


57 (U) 


54 or 56 


5E 


216* 


1000 


D8 




11 


8 




4020 


Q 


D8 


58 (U) 


64 or 66 


IF 


217* 


1001 


D9 




11 


9 




4010 


R 


D9 


49 (U) 


60 or 62 


20 


218 


1010 


DA 


12 


11 


9 8 


2 


C830 












219 


1011 


DB 


12 


11 


9 8 


3 


C430 












220 


1100 


DC 


12 


11 


9 8 


4 


C230 












221 


1101 


DD 


12 


11 


9 8 


5 


C130 












222 


1110 


DE 


12 


11 


9 8 


6 


COBO 












223 ' 


1 mi 


DF 


12 


11 


9 8 


7 


C070 












224 1110 0000 


EO 






8 


2 


2820 












225 


0001 


El 




11 


9 


1 


7010 












226* 


0010 


E2 









2 


2800 


S 


E2 


32 (U) 


98 or 9A 


0D 


227* 


0011 


E3 









3 


2400 


T 


E3 


23 (U) 


9C or 9E 


0E 


228* 


0100 


E4 









4 


2200 


U 


E4 


34 (U) 


B0 or B2 


4F 


229* 


0101 


E5 









5 


2100 


V 


E5 


25 (U) 


B4 or B6 


10 


230* 


0110 


E6 









6 


2080 


W 


E6 


26 (U) 


90 or 92 


51 


231* 


0111 


E7 









7 


2040 


X 


E7 


37 (U) 


94 or 96 


52 


232* 


1000 


E8 






8 




2020 


Y 


E8 


38 (U) 


A4 or A6 


13 


233* 


1001 


E9 






9 




2010 


Z 


E9 


29 (U) 


A0 or A 2 


54 


234 


1010 


EA 




11 


9 8 


2 


6830 












235 


1011 


EB 




11 


9 8 


3 


6430 












236 


1100 


EC 




11 


9 8 


4 


6230 












237 


1101 


ED 




11 


9 8 


5 


6130 












238 


1110 


EE 




11 


9 8 


6 


60B0 












239 ' 


' 1111 


EF 




11 


9 8 


7 


6070 












240* 1111 0000 


FO 











2000 





FO 


1A(L) 


C4 


49 


241* 


0001 


Fl 








1 


1000 


1 


Fl 


01 (L) 


FC 


40 


242* 


0010 


F2 








2 


0800 


2 


F2 


02 (L) 


D8 


01 


243* 


0011 


F3 








3 


0400 


3 


F3 


13 (L) 


DC 


G2 


244* 


0100 


F4 








4 


0200 


4 


F4 


04 (L) 


F0 


43 


245* 


0101 


F5 








5 


0100 


5 


F5 


15 (L) 


F4 


04 


246* 


0110 


F6 








6 


0080 


6 


F6 


16 (L) 


DO 


45 


247* 


0111 


F7 








7 


0040 


7 


F7 


07 (L) 


D4 


46 


248* 


1000 


F8 






8 




0020 


8 


F8 


08 (L) 


E4 


07 


249* 


1001 


F9 






9 




0010 


9 


F9 


19 (L) 


E0 


08 


250 


1010 


FA 


12 


11 


9 8 


2 


E830 












251 


1011 


FB 


12 


11 


9 8 


3 


E430 












252 


1100 


FC 


12 


11 


9 8 


4 


E230 












253 


1101 


FD 


12 


11 


9 8 


5 


E130 












254 


1110 


FE 


12 


11 


9 8 


6 


EOBO 












255 , 


1111 


FF 


12 


11 


9 8 


7 


E070| 
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APPENDIX B. HEXADECIMAL-DECIMAL CONVERSION CHART 



® JS 

XI «" 

C <M 

3 ° 

S aj 
* & 
S o 

a . 

o 6 

^_ 3 

W o 

r-l O 

' a » 

i.s 

-4-> 

*! ST 

B w 



•2 Oi 






u .a 



S S 3 
a § § 

I "3 N 
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APPENDIX C: ASSEMBLER MNEMONICS AND ERROR CODES FOR 2250 ORDERS 



This appendix provides information about the 2250 
orders: their names, mnemonics, and the corre- 
sponding 2250 model 4 orders; coding formats*, and 
notes pertaining to using the orders. The information 
about each order is presented as follows: 

Assembler Order (2250 Order) 



Coding format and Assembler 
mnemonic 



Set Character Mode Basic (Set Character Mode) 




21 


27 


[label] 


SCMB 



Notes: A character mode must be established before 
executing a character stroke or entering a character 
stroke subroutine. 



Notes: Operand limitations, restrictions, signifi- 
cance of format and tag fields, etc. 

Functional descriptions of the 2250, model 4 
orders are contained in the publication IBM 1130 
Component Description: IBM 2250 Display Unit 
Model 4 , Form A27-2723. This appendix is to be 
used in conjunction with that publication. 

Table 2 lists the codes used to identify errors en- 
countered during assembly of the orders, the causes 
of the errors, and the actions taken by the Assembler. 

Set Graphic Mode Vector (Set Graphic Mode) 



21 


27 


[label] 


SGMV 



Notes: The graphic mode vector must be established 
before generating lines. Vector mode is set automat- 
ically if no graphic mode has been previously set 
(see the 2250 model 4 Component Description publi- 
cation). 

Set Graphic Mode Point (Set Graphic Mode) 



21 


27 


[label] 


SGMP 



Notes: The graphic mode point must be established 
before generating points. 



Set Character Mode Large (Set Character Mode) 




21 


27 


[label] 


SCML 



Notes: The notes for SCMB also apply for SCML. 



Set Pen Mode (Set Pen Mode) 



21 


27 


35 


[label] 


SPM 


/hex digit or 
equivalent 



Notes: The operand may be any hex digit or any valid 
absolute Assembler expression in the range to F. 
The bit pattern of a hex 1 digit and the effect of a 1 in 
a bit position are as follows: 



8 



-^ defer light pen interrupts 



"^ enable light pen interrupts 
"=*" disable light pen detects 



^"enable light pen detects 

For example, /9 (1001) defers interrupts and enables 
detects. Hex values 0, 3, C, and F result in no- 
operation. 



My. l 
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Start Regeneration Timer (Start Timer) 



Move* Beam Incremental (Incremental XY) 



21 


27 


[label] 


STMR 

— — — — — _ _ — ______ _ _____ __________ 



21 


27 


35 


[label] 


MBI 


X,Y 



Notes: The STMR order should be the first order in 
an order program. Its use is required for accepting 
keyboard attentions and setting the status of the light 
pen switch. 



Store Revert 


Register (Store Revert Register) 




21 


27 


[label] 


SRVT 



Notes: The SRVT order is used for return linkage 
when multiple levels of subroutines are used. A 
graphic branch indirect through the second word of the 
SRVT order returns control to the calling program. 
The SRVT order should appear in the subroutine pre- 
ceding any graphic branch orders within the subroutine. 

Revert (Revert) 



Notes: The x- and y-coordinates may be any valid 
absolute Assembler expressions, but must be in the 
range +63 to -64. 

*The word "move" here and in the following orders 
relates to blanked beam movement. 

Draw* Beam Incremental (Incremental XY) 



21 


27 


35 


[label] 


DBI 


X,Y 



Notes: In vector mode, beam movement is unblanked*, 
in point mode, only the end point is unblanked. The 
notes for MBI also apply. 

*The word "draw" here and in following orders 
relates to unblanked beam movement. 



21 


27 


[ label ] 


RVT 



Notes: If an order subroutine does not contain any 
graphic branch orders, the RVT order can be used to 
return control to the main order program at the 
order following the branch to the subroutine. If the 
subroutine is two or more levels from the main order 
program, the RVT order does not pass control to the 
main order program. 

Graphic No -operation (Set Pen Mode) 



21 


27 


[label] 


GNOP 



Notes: GNOP is assembled as an SPM order with an 
operand of hexadecimal 00. It can be used to reserve 
a single word in an order stream for later modifica- 
tion. 



Move Beam Absolute (Absolute XY) 



21 


27 


35 


[label] 


MBA 


X,Y 



Notes: The x- and y-coordinates may be any valid 
absolute Assembler expressions, but must be in the 
range to 1023. 



Draw Beam Absolute (Absolute XY) 



21 


27 


35 


[label] 


DBA 


X,Y 



Notes: In vector mode, beam movement is unblanked; 
in point mode, only the end point is unblanked. The 
notes for MBA also apply. 
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Move Beam Absolute X (Absolute X/Y) 



21 


27 


35 


[label] 


MBAX 


X 



Notes: The operand may be any valid absolute As- 
sembler expression, but must be in the range to 
1023. 

Move Beam Absolute Y (Absolute X/Y) 



21 


27 


35 


[label] 


MBAY 


Y 



Notes: The notes for MBAX also apply here. 
Draw Beam Absolute X (Absolute X/Y) 



21 


27 


35 


[label] 


DBAX 


X 



Notes: In vector mode, beam movement is unblanked; 
in point mode, only the end point is unblanked. The 
notes for MBAX also apply. 

Draw Beam Absolute Y (Absolute X/Y) 



21 


27 


35 


[label] 


DBAY 


Y 



Notes: In vector mode, beam movement is unblanked; 
in point mode, only the end point is unblanked. The 
notes for MBAX also apply. 



Move Beam Stroke (Character Stroke Word) 




21 


27 


32 35 


[label] 


MBS 


[r] x,y 



Notes: The x- and y -coordinates may be any valid 
absolute Assembler expressions, but X must be in 
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the range to 6, and Y must be in the range to 7. 
The x- and y-coordinates occupy a half-word. For 
consecutive orders, the coordinates for two orders 
are placed in one word. The revert function is exe- 
cuted if an II is placed in column 32. Character 
stroke orders must be executed out of line by means 
of a graphic branch following a set character mode 
order. 

Draw Beam Stroke (Character Stroke Word) 



21 


27 


32 


33 


35 


[label] 


DBS 


[r] 


[D] 


X,Y 



Notes: A D in column 33 indicates that less than 
normal (decreased) intensity is desired (recom- 
mended for character strokes less than 2 character 
units long-, see the 2250 model 4 Component De- 
scription publication for details about character 
units). Programmed intensity provides a means of 
generating characters that have nearly uniform 
intensity for all the strokes of the character regard- 
less of the stroke lengths. The programmer should 
experiment with this facility to achieve desired 
results. The notes for MBS also apply. 

Control Stroke (Character Stroke Word) 



21 


27 


32 


35 


[label] 


CS 


[R] 


1, [data] 


[label] 


cs 




2, [data] 


[label] 


CS 


R 


2, [data] 


[label] 


CS 


[R] 


4, [data] 


[label] 


CS 


R 


7, [data] 



Notes: The first operand, which may be any valid 
absolute Assembler expression, has the following 
meanings: 



1 = subscripting 

2 = no operation 
2 = null function 

4 = supers cripting 

7 = new line 



- the character grid is offset 
downward 3 vertical charac- 
ter units. 

- the order performs no opera- 
tion if R is not specified. 

- the order performs a null func- 
tion if R is specified. 

- the character grid is offset 
upward 3 vertical character 
units. 

- the beam is positioned at the 
next line (R must be specified) . 
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The "data" operand may be any data the program- 
mer wants, but must not exceed 7 bits. Data exceed- 
ing the limit is truncated to the 7 low -order bits. 

If revert (R) is not specified for the superscript 
control order, execution continues with the second 
word after the superscript control order. Placing a 
subscript control after the superscript control order 
gives a character stroke subroutine the capability of 
being executed in superscript, subscript, or normal 
mode if different entry points to the subroutine are 
defined. 

Graphic Short Branch (Short Branch) 



21 


27 


35 


[ label J 


GSB 


address 



Graphic Branch External (Long Branch/Interrupt) 



21 


27 


33 


35 


[label] 


GBE 


[N] 


name 



Notes: Name is the name of an external order pro- 
gram (subroutine). An N in column 33 specifies a two- 
word no operation. 



Graphic Branch Conditional External (L 


ong Branch/ 


Interrupt) 


21 


27 


33 


35 


[label] 


GBCE 


[N] 


name, 
condition 



Notes: The address may be either symbolic or an 
absolute Assembler expression, but must have a value 
less than 8192. Use of the symbolic operand is re- 
stricted to referring to graphic orders that are within 
the same Assembler -language program. 

Graphic Branch (Long Branch/Interrupt) 



21 


27 


32 


33 


35 


[label] 


GB 


[I] 


[N] 


address 



Notes: An I in column 32 specifies an indirect branch. 
An N in column 33 specifies a two -word no -operation. 
The notes for GSB also apply, except that the address 
is not restricted to a value of less than 8192. 



Graphic Branch Conditional (Long Branch/Interrupt) 




21 


27 


32 


33 


35 


[label] 


GBC 


[I] 


[N] 


address , 
condition 



Notes: The conditions for the branch are the same as 
those described for GBC. The notes for GBE also 
apply. 

Graphic Interrupt (Long Branch/Interrupt) 



21 


27 


33 


35 


[ label ] 


GI 


[N] 


[data] 



Notes: An N in column 33 specifies a two-word no- 
operation. Data may be a symbolic address, number, 
or expression. The range of numerical data or an 
expression, when resolved, must be +32767 to -32768. 
The data word may be used for any purpose. 

Graphic Interrupt Conditional (Long Branch/Interrupt) 



21 


27 


33 


35 


[label] 


GIC 


Cn] 


[data], 
condition 



Notes: The condition for the branch may be one of 
the following: 

D = branch if light pen detect 
S = branch if light pen switch closed 
DS or SD - branch if light pen detect and 
switch closed 



Notes: The condition for the interrupt may be one of 
the following: 

D = interrupt if light pen detect 
S = interrupt if Tight pen switch closed 
DS or SD = interrupt if light pen detect and switch 
switch closed 



The notes for GB also apply. 



The notes for GI also apply. 
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Table 2. Assembler Error Codes for 2250 Errors 



Error 
Code 


Cause 


Action Taken by 
Assembler 


W 
X 
Y 
Z 


x- or y -coordinate, or both, not within the spec- 
ified range*, or invalid operand 

Character other than R or I in column 32; or 
character other than D or N in column 33. 

Unnecessary operand specified; or unnecessary 
Tag or Format field entry. 

Invalid condition in a conditional branch or 
or interrupt order. 


Operand set to zero. 

Field set to zero. 

Operand ignored; Tag or Format field 
ignored. 

Condition bits in first word set to zero. 
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